DocsScreens
Dashboard
The Dashboard is the first screen you see. Each repository you add is a card with a dial: when it last moved, what changed, and where its worktrees stand.
Toolbar
- Workspace · N Tabs returns to your open tabs (⌘0). It appears once a tab is open.
- Hindsight (⌥⌘R) and Insight open those screens. See Hindsight and Insight.
- Add Repository adds a repository. See Add repositories.
Sort the cards
Above the cards, sort by Recent (newest commit first), Commits (most first), Stale (longest since a commit first), Name, or Changed (uncommitted changes first).
Read a card
A card's header shows the repository name and its main worktree's branch, with Clean, N commits or the number of changed files below. The dot before the branch changes color with uncommitted changes and fades after 14 days without a commit.
On the dial, time runs clockwise from Now at 12 o'clock. A lap spans a day to a year, depending on recent activity, and anything older gathers just before 12. Bars around the rim count commits. Below the dial are up to three numbers and the two latest commits.
One worktree
The needle points at the last commit, and the center shows Last commit, how long ago it was, and the commits in this lap. After a quiet spell, the band from Now to the needle stays empty and reads Quiet for Nd. Faint dots are commits from the previous lap.
The numbers come by priority: Conflicts, Changed files, No commits after 14 days, Unpushed (against your last fetch), Commits today, and Total commits. Each listed commit is marked Direct commit, Agent, Bot or Merge, with the lines it added and removed.
Several worktrees
Worktrees are measured against the repository's Analyzed Branch, the base (see Repositories and worktrees). The base's latest commit is the solid circle on the ring, which also stands for any worktree on that branch. The shading inside is the base's history, one lap further back with each turn inward.
A worktree without commits of its own sits on the ring at its checked-out commit, and several on one commit become a numbered ring. One with commits ahead sits inside at the time of its latest commit, nearer the center the more it has, with a line from where it branched off. Many working worktrees in one spot merge into N working at once.
A dot's color shows its state, and the counts appear under N worktrees below the dial:
- Working: it has commits ahead of the base, the latest under 30 minutes old.
- Needs rebase: it has commits of its own and is 50 or more commits behind the base.
- At rest: anything else.
If there is no base branch, the line reads N worktrees · no base and distances aren't measured.
Open and manage a repository
Files and Graph on a card open the repository in the Workspace. See Workspace. Right-click a card for Reveal in Finder, Refresh and Remove, covered in Add repositories.