<!-- https://ouijit.com/docs/terminals/ · rendered as Markdown for agents and LLMs -->

# 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](https://ouijit.com/docs/harnesses/).

## Keyboard shortcuts

| Shortcut | Action |
| --- | --- |
| `⌘K` / `Ctrl+K` | Open the [command palette](https://ouijit.com/docs/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](https://ouijit.com/docs/panels/) |
| `⌘D` / `Ctrl+D` | Toggle the [diff panel](https://ouijit.com/docs/diff/) |

## 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](https://ouijit.com/docs/resume/) 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`](https://ouijit.com/docs/cli/).
