Skip to content
GitTree
History and recovery

Use repository maintenance and author tools

Repository Maintenance… shows the size of the object database and runs tasks that check it or make history and status faster. Merge Author Identities… writes .mailmap lines so one person with several names or e-mails shows as one author.

FreeUpdated

Works in GitTree Free: every local Git feature, once you are signed in.

On this page
  1. Before you start
  2. Where to find it
  3. Steps
  4. Expected result
  5. Maintenance tasks
  6. If something goes wrong
  7. Questions
  8. Related

Before you start

  • A repository open in GitTree. Nothing runs until you start it.

Where to find it

  • The command palette: Repository Maintenance… and Merge Author Identities….
ActionmacOSWindows and Linux
The command palette⌘⇧PCtrl+Shift+P

Steps

  1. Read the counts

    Open Repository Maintenance…. Object database shows its Size on disk, Loose objects, Packs and any Stray files.

  2. Check integrity

    Check under Check integrity runs git fsck to look for missing or damaged objects. It changes nothing.

  3. Speed things up

    Run the tasks you need from the table below. Each says what it changes before you run it.

Expected result

The repository is checked and its history, references and status load faster.

Maintenance tasks

What each maintenance task does
TaskWhat it does
Speed up historyWrites the commit-graph file, so the graph and history load faster.
Keep the commit-graph freshSets fetch.writeCommitGraph=true, so every fetch updates it.
Pack referencesMoves loose branch and tag references into one file.
Speed up statusSets core.untrackedCache=true and builds the cache.

Merge Author Identities…: choose Keep this identity, then the identities that are the same person under Show these as the kept identity, and press Merge Identities. Commit .mailmap to share it.

If something goes wrong

“The object counts could not be read.”

Close other programs using the repository and open the dialog again; run Check integrity if it persists.

Questions

Does .mailmap rewrite history?

No. It only changes how names are shown; every commit keeps the author it was made with.