Search the field guide

Search all 29 chapters. Your search stays on this device.

↑ ↓ Move between results Enter Open · Esc Close

Browse chapters

DocsStart hereFIELD NOTES / 01

Start here · 1 min read

What GitTrail does

Preview documentation About this guide ⓘ

GitTrail is in preview: commands and features may change before the first release, and host integrations are still being tested against each live service.

Chapter 1 of 29
On this page

In this chapterUnderstand how accounts, identity rules and the Git workspace fit together.

Many developers have more than one Git identity: a work account, a personal one, perhaps accounts for clients. Git itself doesn’t know which one you mean, so it’s easy to:

  • push with the wrong SSH key and get “Permission denied (publickey)”,
  • commit with your personal email on a work project (or the reverse),
  • end up with a complicated ~/.ssh/config full of host aliases.

GitTrail solves this once:

  1. You add each account (name, email, SSH key, optional token).
  2. You tell GitTrail which account belongs where: one repo, a whole folder, or every repo from an organisation.
  3. From then on, every commit and push uses the right account automatically, in GitTrail and in any other Git tool.

On top of that, GitTrail is a full visual Git client: a colourful commit graph, drag-and-drop merging, a conflict editor, pull requests, CI, and undo for everything.

GitTrail has three faces that share the same engine:

Face How to open it Good for
Desktop app gittrail ui, or the app icon Everyday work, visual Git
Interactive terminal gittrail with no arguments Quick account picking in a terminal
Commands gittrail use work, gittrail doctor… Scripts and power users
Need another approach?Find a fix →