# Chat Tabs

Without chat tabs, an agent runs in a terminal [tab](/docs/panels): you scroll raw output and answer prompts by typing. A chat tab is a tab that shows the agent as a conversation: your messages, its replies, and buttons for its approvals. It runs the same CLI you installed and signed in to. When a turn ends, its steps fold into one row, such as "Worked for 27s", that opens to what the agent did.

| You do | What happens |
| --- | --- |
| Click **+** in a Pane and pick an agent under **New tab** | A chat tab opens with that agent. Terminal agents sit below, under **In a terminal**. |
| Right-click a terminal agent tab, or a [Session](/docs/sessions), and choose **Switch to chat…** | The terminal's conversation continues in a chat tab. See [Switch a terminal tab to chat](#switch-a-terminal-tab-to-chat). |
| Type `/resume` | A picker lists this folder's past conversations. See [Pick up a past conversation](#pick-up-a-past-conversation). |
| Drop, paste or pick a file with **+** | A PNG, JPEG, WebP or GIF up to 5 MB goes to the agent as an image, if the agent takes images. Anything else up to 10 MB, larger images included, is copied to `.pane/files/` in the Pane's folder, and its path is sent with your message. |
| Send a message while the agent works | It waits in the queue. **Send now** (Cmd/Ctrl+Enter) interrupts the turn and sends it first. |
| Type `/clear` | The agent starts a fresh conversation in the same tab, with the same settings. |

## Set it up

Chat tabs are on in a fresh install. They're a switch on the **Settings → AI & Agents** page: **Chat tabs**. Turn it on if your install is older, or off to go back to terminals. Off, the **+** menu drops its chat entries and new Sessions start in a terminal. Open chat tabs keep working, and a chat tab can't move back into a terminal. With it on, new Sessions open their orchestrator (the agent that coordinates the rest) as a chat.

Chat tabs don't run in WSL projects or on SSH hosts. Use a terminal tab there.

A separate page, **Settings → Agents**, lists the agents this machine can open as chats. Full access lets the agent act without asking you before each step:

| Agent | How you turn on full access | Switch to chat |
| --- | --- | --- |
| Claude | Its own Bypass mode | Yes, the exact conversation |
| Codex | Its own Full access mode | Yes, the most recent conversation |
| Cursor | Pane's **Full access** setting in the composer menu | No |
| OpenCode | Pane's **Full access** setting. Pane answers each of the agent's approval requests with allow once, and marks that step "Approved by Pane". | Yes, the most recent conversation |

Each row shows its version when Pane knows it (Claude and Codex rows don't), an **Install** link if it's missing, and what it supports: **Reopens chats**, **Lists past chats** and **Images**. Pane learns those the first time it starts a chat with the agent. Below them, **More agents from the ACP Registry** installs other agents that speak the [Agent Client Protocol](https://agentclientprotocol.com) with one click.

### Sign in

A chat tab uses the agent's own sign-in on the machine it runs on. Pane never reads or copies it. If you aren't signed in, the tab stops with **Sign in in Terminal**, which opens a terminal tab running the agent's login (`claude auth login`, `codex login`). Sign in there, then press **Retry**.

You can also save an API key per agent in **Settings → AI & Agents → Chat tab sign-in**. It stays in that machine's secure store, and only that agent's chat tabs get it. See [AI providers](/docs/providers) for each agent's account options.

> **Note:** Chat tabs need recent CLIs: Claude Code 2.1.316, Codex 0.165.0, Cursor 2026.10.22 or OpenCode 1.18.14. An older one stops the tab with the command that updates it.

## Switch a terminal tab to chat

**Switch to chat…** carries the terminal's conversation into a chat tab. It's also in Open Search (⌘⇧P). Pane shows one confirmation dialog. Confirm, and it stops the terminal agent, opens the chat in the terminal tab's place and closes the terminal. Switching a Session's orchestrator makes the chat tab its new orchestrator.

On a Session, **Switch to chat…** switches every terminal agent tab in it. A dialog first lists which tabs will switch and which it'll skip, with why.

Which conversation opens:

- **Claude** tells Pane its conversation every time it starts, resumes or clears. The chat loads that exact one.
- **Codex, OpenCode** and a Claude terminal started before you updated Pane open the folder's newest conversation that isn't open in another tab. A banner says "Opened the most recent conversation here" with **Pick another**.

A Session-wide switch opens only conversations Pane is sure of. Switch an unsure tab from its own menu instead.

> **Warning:** Pane won't switch a tab mid-turn. Wait or stop the agent first. If the chat fails to open, the dialog says why and offers **Try again**. When Pane knew the conversation, the terminal comes back on it.

## Pick up a past conversation

Type `/resume` in any chat tab, or click **Pick another** on the switch banner. The picker lists this folder's conversations, newest first. Pick one to load it with its history. It marks this tab's conversation "open here". One open in another tab shows "Open in tab …" and can't be picked, so two agents never write to one conversation. You can't pick while a turn runs or messages wait in the queue.

After Pane restarts, a chat tab reloads its conversation when you open it. A turn that was running shows *Stopped when Pane closed*, and your next message continues the same conversation.

## When something goes wrong

- **Not installed**: the tab says so, with the command that installs it. Install it, then press **Retry**.
- **Signed out**: use **Sign in in Terminal**, then **Retry**. The tab never retries by itself.
- **Switch to chat is greyed out**: its menu row says why. Cursor's chat can't load terminal conversations, and **Turn on chat tabs** appears when chat tabs are off.
- **Codex says "in use by another Codex client"**: the terminal ran Codex through its shared background service (`codex app-server daemon`), which keeps the conversation after the terminal stops. Pick another conversation, or start a new one.
- **The agent exited**: press **Restart**. It loads the same conversation.
