DocsScreens

Workspace

The Workspace holds a tab for each worktree, an agent tile on each tab, and the Terminal Dashboard. Press ⌘0 to switch between it and the Dashboard.

Tab bar

Each tab is one worktree and always stays that worktree; see Repositories and worktrees. A tab shows the repository name and branch, plus the folder name for a worktree other than the main one. The dot on the branch symbol marks uncommitted changes.

Tabs of one repository sit together, even when you drag tabs to reorder them. When the tabs don't fit, they all shrink alike: branch lines go first, then names shorten to three letters, but agent tiles stay.

Agent tiles

Each tile is a small view of its tab's main terminal. Click it to go to that tab and open the terminal. On a tab without one, click the empty tile (New Terminal) to start one in that worktree.

With Claude Code running, the tile shows:

  • The agent name, with a cursor that blinks while it works
  • Claude Code sessions in the top circle, and running subagents in the bottom one, green while any run
  • A waveform of output tokens from the last 30 seconds; small bars at its base mean background shells are running
  • Context use of the fullest session, with ~ when the window size is estimated
  • Memory used, in the warning color when it's unusually high for this worktree
  • ⚠ when the agent's last turn left a hidden coupling warning

Other agents show only their name; see Supported agents and hosts. An accent border means a bell or notification, and ? a terminal that seems to be waiting. Tiles on other tabs stay gray, and pulse when something there is new to you.

Terminal Dashboard

When two or more main terminals run across your tabs, a grid icon appears at the left end of the tab bar. Click it to see them all side by side in the Terminal Dashboard. It's read-only: it mirrors the terminals but takes no typing. Double-click a pane to open that terminal in its tab, or press Esc to close.

Toolbar

  • Dashboard returns to the Dashboard, leaving your tabs as they are.
  • Graph, Files and Overview switch the tab's screen, and each keeps its state. See Graph, Files and Overview.
  • The worktree menu goes to another worktree's tab, opening it if needed. New worktrees never open tabs by themselves.

Keyboard shortcuts

These are in the Window menu; see Keyboard shortcuts for the rest.

  • ⌘0: Dashboard or Workspace
  • ⌃⌘P: Switch Repository…, also the + at the end of the tab bar
  • ⌃Tab and ⌃⇧Tab: Next Repository Tab and Previous Repository Tab
  • ⌘1 to ⌘9: go to that tab
  • ⌘⇧W: Close Repository Tab

When a worktree is removed

If a worktree is removed, for example by an agent's git worktree remove, its tab stays open so its terminal isn't ended without asking. The tab shows Worktree not found; click Close Tab when you're done.