Search the field guide

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

↑ ↓ Move between results Enter Open · Esc Close

Browse chapters

DocsReferenceFIELD NOTES / 25

Reference · 1 min read

The command line

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 25 of 29
On this page

In this chapterFind a command or follow the terminal setup example.

Command What it does
gittrail Pick an account for the current repo (arrow keys)
gittrail add · edit · rename · remove · list · show --check Manage accounts
gittrail use <account> [--global] Use an account in this repo, or as the default
gittrail auto <account> <folder> Folder rule
gittrail auto <account> --remote github.com/acme Remote rule
gittrail auto --list · auto --remove <folder> List or remove rules
gittrail current Which account is active here, and why
gittrail doctor [--ssh] Check that pushing will work
gittrail clone <account> <url> Clone as an account
gittrail keygen · upload-key · import · fix Setup and fixes
gittrail guard --on / --off The push check
gittrail token set / rm <account> HTTPS tokens
gittrail ui · gittrail . Open the app (on a repo)
gittrail open history · changes · prs · blame <file> · commit <sha> Open a view in the app
gittrail link <gittrail://…> Open a deep link
gittrail license Your plan: sign in, upgrade, refresh
gittrail update · version Updates and version

Quick start in a terminal

# 1. Create an account for each identity
gittrail add work --name "Jane Doe" --email jane@acme.com --host github.com
gittrail add personal --name "Jane" --email jane@example.com --host github.com

# 2. Pick a default, then map folders
gittrail use personal --global
gittrail auto work ~/code/work

# 3. Check it
cd ~/code/work/shop && gittrail current && gittrail doctor --ssh
Need another approach?Find a fix →