Workspaces & sessions

The workspace tree

The left sidebar is a tree with three levels. A workspace is a folder you have opened — git repositories show a branch badge. Under each workspace sit its refs: a row for main, plus a row per branch or worktree that agents are using. Under each ref sit the agents and tabs running there.

• Agent rows show the agent's name, a status dot (pulsing while it works), and a second line naming its branch or worktree. While a fresh worktree is being set up, that line reads Setting up worktree….
• Terminal, browser, and file tabs appear as sibling rows with their own icons — browser rows show the page title.
• Hovering a row reveals ✕ to close it; refs and workspaces have their own ✕ with a confirmation when open tabs would be affected. If a worktree's setup failed, a ⟳ on the ref row re-runs it.
• Two panes split on the same ref collapse into one outlined group card in the tree, so a pair reads as a pair.

Finding the session that matters

The filter next to the Workspaces header narrows the tree to Working, Idle, or Needs you agents. When something is blocked on you — a question, a permission, a rate limit — a required actions banner pins to the top of the sidebar; clicking an entry jumps straight to that agent's pane. (More in Notifications & recaps.)

Subagents

When an agent spawns subagents, a subagents (N) disclosure appears under its row. Opening one shows a read-only transcript pane — you can watch a subagent, but you talk to its parent. Each parent keeps at most one subagent tab open, retargeting it as you click through the list.

Resuming, forking, and renaming

The Sessions button (or + ▸ Resume session…, or /resume in the composer) opens the session picker: every resumable Claude Code session, newest first, with its age, message count, and branch or worktree chips. Sessions already open in a tab carry an Open badge.

• Open resumes the session in a tab, exactly where it left off.
• Fork starts a new session from that conversation's history, leaving the original untouched.
• Rename (pencil, or right-click a tab) edits the name inline — names animate as agents rename themselves, too.
• The footer offers Continue most recent and New chat.

The sidebar footer

The footer shows your connection to the local agent host by machine name — its popover offers Reconnect and Sign out — alongside buttons to add a folder and open Settings, and the usage meter for your Claude subscription windows (see Models & usage). The sidebar itself collapses with ⌘B.