Terminals

The sidebar lists every project's tasks and terminals. Pick one and it fills the window.

Sidebar

Under Projects, each project lists its tasks in board order. A task with several terminals shows each one under it. A task in progress or in review with no terminal open is listed too, marked with a moon until you open one. Shells that belong to no task come after the tasks. An agent that finished while you were looking elsewhere gets a blue dot until you open it, here and everywhere else it is listed.

Click a project to go back to the board or terminals you last had open there, even after a restart. Click its arrow to fold it away. Dots next to the name then show which agents are still working and which have finished unseen. On the board, Terminals stacks every terminal open in the project.

A project's row has buttons for its board and a new task. Its … menu, also on right-click, opens a new terminal, on your computer or in one of the project's sandboxes. The same menu opens the project's pull requests, issues, analysis and settings. Right-click a task for the same menu the board gives it. Switch to Tags to list terminals under their tags instead, with untagged ones under No tag. Hide the sidebar with the button at its top. Hover the left edge to bring it back.

Card stack

Each terminal runs your default shell in the task's worktree. A task's terminals stack, with the active one in front and the rest peeking out behind it. Click a background card to bring it forward. Cards stay in the order you last used them, so the one you just left is directly behind the one in front. A shell is a card of its own. When an agent runs in a card, its status (thinking or idle) shows on the card even when it is behind others. See Supported agents.

Keyboard shortcuts

ShortcutAction
⌘K / Ctrl+KOpen the command palette
⌘I / Ctrl+INew terminal in the project on screen
⌘W / Ctrl+WClose terminal
⌘1-⌘9 / Ctrl+1-Ctrl+9Select a card in the stack by position
⌘T / Ctrl+TOpen the project's board
⌘N / Ctrl+NNew task
⌘P / Ctrl+POpen the runner panel
⌘D / Ctrl+DToggle the diff panel

Tag terminals

Tag a terminal from the tag button on its card. A terminal can carry several tags, and two terminals of one task can carry different ones. Tags survive a restart. The sidebar's Tags view groups what's running by them, listing a terminal under each of its tags.

Manage tags from the shell or an agent with ouijit tag.

Resume a session

Resume banner listing the previous session's terminals

With nothing open, the window offers to resume your last session and lists recent tasks.

Quitting saves your open terminals: their project, task, worktree, sandbox, order, tags, and panels, with split sizes and the diff panel. On the next launch, Resume last session reopens each one in its worktree with its panels. Dismiss clears it. Terminals whose project or task is gone, or whose task is Done, are skipped.

Restored terminals come back as plain shells, so resuming never starts an agent on its own. To pick up an agent's conversation, use its own resume, such as a continue hook running claude -c.