# Tabs

<PanelBar />

A tab is a view inside a pane: an agent, a terminal, a browser, a file you opened, or a file's diff. Every tab in a [pane](/docs/panes-and-worktrees) starts in that pane's worktree and branch, so a second agent on the same feature needs no setup.

> **Note:** The [`runpane` CLI](/docs/runpane-cli) calls tabs "panels". The **right panel** is separate: the side area with **Details** (branch, git actions, history), **Files** and **Changes**.

| You do | What happens |
| --- | --- |
| Press ⌘⌥3 | A Claude Code tab opens. |
| Press ⌘T, or click **+** in the tab bar | The add menu lists every agent, Terminal, Explorer and Browser. |
| Press ⌘⇧[ or ⌘⇧] | Pane moves to the previous or next tab. |
| Press ⌘⌥B | The right panel opens. |

On Windows and Linux, use Ctrl for ⌘ and Alt for ⌥, and Ctrl+PageUp / Ctrl+PageDown to cycle tabs.

One feature, one pane. Open another tab for a review, audit or QA of the same feature. Open another pane for a new feature. Agents add tabs with `runpane panels create --pane <id>`.

> **Warning:** Tabs in a pane share one checkout. A branch switch or reset in one tab changes it for all of them. Only the implementing tab should switch branches or reset.

There's no fixed limit on tabs. Each terminal and agent tab is its own process, so your machine's RAM and CPU are the cap.

## Split tab groups

Arrange tabs side by side within a pane, VS Code style. Any tab can join a split. Run two agents next to each other, or keep a diff beside the agent writing the code.

### Drag and drop

Grab a tab and drag it over the tab area:

- Drop on the **left, right, top, or bottom edge** of a group to split in that direction.
- Drop on the **center** of another group to move the tab into it.
- Drop **between tabs** in a strip to reorder.

Drag the divider between groups to resize them.

### Keyboard

| Action | macOS | Windows / Linux |
|--------|-------|-----------------|
| Split right | ⌘\ | Ctrl+\ |
| Split down | ⌘⇧\ | Ctrl+Shift+\ |
| Move focus between groups | ⌘⌥ Arrow keys | Ctrl+Alt+Arrow keys |
| Maximize or restore the focused group | ⌘K, then ⌘M | Ctrl+K, then Ctrl+M |
| Jump to tab 1 to 9 in the focused group | ⌘⇧1-9 | Ctrl+Shift+1-9 |
| Close the active tab | ⌘W | Ctrl+W |

Splitting, or moving focus to another group, exits maximize. The layout persists per pane across restarts. The terminal docked at the bottom (Ctrl+\` toggles it) never joins a split.

## Changes

<DiffPreview />

**Changes** in the right panel lists every file changed in the worktree and refreshes as the agent writes. Click a file to open its diff as a tab. See [Review & Commit](/docs/review-and-commit).

## Files

**Files** in the right panel is the worktree's file tree, with search, rename, move and drag and drop. Files open in an editor tab: Monaco, the editor behind VS Code, with syntax highlighting and auto-save. Markdown, Mermaid, notebooks, images and PDFs open as previews. It's for quick edits and checks, not a full IDE.

## Browser

A browser tab previews your running app next to the terminal.

## Terminals

<TerminalPreview />

Run any CLI agent in a terminal tab: Claude Code, Codex, Cursor, OpenCode, Pi, Aider, Goose, or a [custom command](/docs/custom-agents). Each terminal keeps its last 2,500 lines, saved across restarts. Images drawn with the Sixel, iTerm2 or kitty graphics protocol show inline.

<Toggle title="Tab keyboard shortcuts">
| Tab | macOS | Windows / Linux |
|-----|-------|-----------------|
| Terminal | ⌘⌥1 | Ctrl+Alt+1 |
| Claude Code | ⌘⌥3 | Ctrl+Alt+3 |
| Codex | ⌘⌥4 | Ctrl+Alt+4 |
| Cursor | ⌘⌥5 | Ctrl+Alt+5 |
| OpenCode | ⌘⌥6 | Ctrl+Alt+6 |
| Pi | ⌘⌥⇧P | Ctrl+Alt+Shift+P |
| Custom commands | ⌘⌥7, 8, 9, 0 | Ctrl+Alt+7, 8, 9, 0 |

⌘⌥2 opens **Files** in the right panel.
</Toggle>
