Terminals
Terminals are cards in a stack. The active one is in front; the rest peek out behind it so you can see what's running.
Card stack
Each terminal runs your default shell in the task's worktree. Click a background card to bring it forward. When an agent runs in a card, its status (thinking or idle) shows on the card even when it is behind others. See Harnesses.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
⌘K / Ctrl+K | Open the command palette |
⌘I / Ctrl+I | New terminal |
⌘W / Ctrl+W | Close terminal |
⌘1-⌘9 / Ctrl+1-Ctrl+9 | Select terminal by position |
⌘⇧← / Ctrl+Shift+Left | Previous stack page |
⌘⇧→ / Ctrl+Shift+Right | Next stack page |
⌘T / Ctrl+T | Show or hide the kanban board |
⌘N / Ctrl+N | New task |
⌘P / Ctrl+P | Open the runner panel |
⌘D / Ctrl+D | Toggle the diff panel |
Home view
The home view shows every live terminal across all projects in one stack, grouped by project. Click a
group's tab to bring it forward. Terminals that don't belong to a registered project appear as
Shell. Press ⌘T there to group by tag instead, and ⌘I to open a
shell in your home directory.
When nothing is running, the home view offers to resume your last session and lists recent tasks so you can pick up where you left off.
Tag terminals
Tag a terminal from the tag button on its card. Tags belong to the task, so every terminal of the task carries them. Use tags to slice what's running:
- Project view. A filter pill next to the toolbar buttons shows only matching cards. It appears once any session carries a tag.
- Home view. The tag control groups sessions by tag, or filters to one tag. Untagged sessions group under Untagged.
Manage tags from the shell or an agent with ouijit tag.