Companion list
The list of the companion shows your conversations. Each row opens its chat where it lives.
The list
Click the companion circle, or press its shortcut, to open the list. Type to search.
| Group | What it holds |
|---|---|
| Needs you | Chats waiting for a permission, then an answer, then unread replies. Newest first. |
| Working | The agent is busy. |
| Active | Open chats, and app or cloud chats until you archive them. |
| Archived | Closed chats, and chats you archived in their app. |
Details: keys
| Key | What it does |
|---|---|
| ⌃⌥V on a Mac (Ctrl+Alt+V elsewhere) | Open the send picker from any app. You can change it. |
| Cmd+Shift+V | Open the send picker in the open list, keeping your search. |
| Arrow keys, Enter | Pick a chat, then open it or send to it. In the right-click menu, move between its items. |
| Escape | Cancel the picker, or keep the old name in a rename. |
| F2 | Rename the selected row. |
Open a chat
Click a row to reach its chat.
| Chat | What a click does |
|---|---|
| Running in Terminal or Ghostty | Selects its tab. |
| Ended terminal chat | Resumes it in a new tab. |
Claude Code --bg session | Selects the tab that runs claude attach, or opens one. |
| Anything else | Opens its app, editor or browser. |
If a chat does not open, the reason stays above the list.Details: tabs, background sessions, slow opens, resume command
claude --bg runs in Claude's own background service, not in a terminal app.e3469759, or its exact full name. A tab attached with the start of an id or part of a name is not recognized, since it may be another session.claude attach <id> in the session's folder, in the app it last ran in when it remembers one.claude agents --json.claude is looked up on PATH, then in ~/.local/bin, ~/.claude/local, /opt/homebrew/bin and /usr/local/bin.claude agents cannot run or does not list the session, the list offers the claude attach command to copy, or says to find its id with claude agents and run claude attach <id>.tmux session or after its tab closed. It comes with a note to end that process first, since two copies of one session would compete.
Send copied text
Send text you copied to any chat without switching apps.
- Copy text anywhere.
- Press ⌃⌥V on a Mac (Ctrl+Alt+V elsewhere). The list opens with a banner such as "Click a chat or press Enter to paste these 14 words there".
- Click a chat, or pick one with the arrow keys and Enter. Escape cancels.
| Chat | What happens |
|---|---|
| Live Terminal or Ghostty tab | It comes forward with the text in its input. Press Enter. |
| Any other chat | It comes forward. Paste with Cmd+V. |
Only one chat can take text? It goes straight there. Change the shortcut under Send copied text in the list's ⋯ menu or the circle's right-click menu.Details: which chats, search, Markdown, permissions, errors
agnostic-ai serve.POST /api/conversations/send.
Rename a chat
Give a chat your own name. The web interface shows the same name.
- Right-click a row and choose Rename… (or press F2, or use the pencil).
- Type the name. Enter saves, Escape keeps the old name.
The chat's own tool takes the name first. Only then is it saved, so every serve on the machine shows it and finds it in a search. If the tool refuses, the field stays open with the reason, such as "Codex is not installed". Claude app chats, Cowork tasks and Codex cloud threads cannot be renamed yet.Details: how each tool is renamed, where the name lives, errors
Chat How it is renamed Claude Code Adds the custom-title line Claude Code's own /rename writes.Claude Code cloud session Changes the title on claude.ai/code, using the login Claude Code keeps in the macOS keychain. Codex Asks codex app-server to rename the thread (thread/name/set). Needs codex.Cursor Changes the name in Cursor's own database. Needs sqlite3.ChatGPT Asks chatgpt.com to change the title, using the ChatGPT login the Codex command keeps. Claude app chat, Cowork task, Codex cloud thread Cannot be renamed yet. conversation-marks.json, only once the tool has it.store.db, only when a look at the open files just before the write finds the chat not running.
Mark chats as read
Clear a chat that needs you without opening it.
- Mark as read: right-click the chat.
- Mark all as read: the button beside Needs you, while the group is unfolded. It marks each chat the group shows, after the search and the All, Local or Cloud choice.
The chat leaves Needs you in the companion and the web interface, and moves where an opened one would: Active, or Archived when closed.Details: same mark as opening, failures, the circle count
state.
Rows and order
A row shows the title, the agent's latest reply in one line, and a meta line.
| Part | What it shows |
|---|---|
| Meta line | Tool, where it runs when not here (Cloud, Chat, Cowork or Shared), folder, age. |
| Reply line | The agent's question, or the start of its last message. |
| Approval pill | Orange, replaces the reply line while a call waits for approval. |
| Approval reason | Under the pill, why approvals left the request to you. |
| Approved for you | "▸ 3 approved for you" under the meta line, while approvals answer prompts. |
A chat started with conversations start sits under its parent in the same group.
See what a chat waits for for where each tool's wait comes from.Details: pill kinds, folders, replies, pill limits, child chats
Pill Waiting on Approve git push origin…A command (its first words). Approve edit dashboard.tsxAn edit or a write. Approve read .env.exampleA read. Approve github.comA fetch. Approve Notion fetch An MCP tool. Needs permission A call that is not known, as for a Codex cloud thread. shop/api and billing/api.reply.
Working rows and subagents
Working chats show an animated gyroscope. Each working Claude Code or Codex subagent adds a small blue copy.
| Part | What it shows |
|---|---|
| "▸ 3 subagents" | A line under the meta line. Click it to unfold. |
| Unfolded list | Newest first, five at most, then "+N more". |
| Subagent row | Gyroscope, title, a Claude Code subagent's latest message when it wrote one, tool, type if any, age. |
A Codex subagent opens its own thread, or switches to its terminal. A Claude Code subagent opens its chat, and a notice names the subagent. For a chat in a terminal tab, it also says to switch to it in the agent rows below the prompt. A failure that comes later replaces the notice. In the send picker, a click on a subagent row sends the text to the chat it runs in.Details: counts, parents, animation
codex exec runs count among them while they run.
Archived chats
A chat moves to Archived when it is closed.
| Chat | When it archives |
|---|---|
| Terminal chat | As soon as no process holds it, even with an unread reply. |
| Editor panel, Claude Code background job | A day after its last write. |
| Desktop app session, Claude chat, Cowork task, ChatGPT chat, cloud session | Only when you archive it, here or in its app. |
Archiving here never changes the chat in its app. Click an archived chat to resume it.Details: unread replies, resuming, working chats, silent Codex chats
conversation-marks.json, so the web interface agrees and the chat does not go back to Archived when the work ends.
Shared Remote Control rows
A local Claude Code session shared with claude.ai through Remote Control is one row, marked Shared. It stays one row once it closes. Marking it read, or opening it on claude.ai, clears both.
| Event | What happens |
|---|---|
| A claude.ai reply within two minutes of the session's last reply | It stays folded into the archived shared row, which shows no ring. |
| A later reply | The cloud row shows alone, under Needs you. |
The server restarting, or resuming without Remote Control, shows two rows again. Deleting the local session leaves the cloud row.Details: unconfirmed disconnect activity, restarts
What a chat waits for
A row that waits for you carries waiting when its tool says what for: {for, tool?, detail?}. for is permission (approve a tool call) or answer (a question). It is omitted when unknown.
| Tool | Where the wait comes from |
|---|---|
| Local Claude Code | waitingFor in sessions/<pid>.json. |
| Codex cloud | waitingOnApproval is permission, waitingOnUserInput is answer. |
| Local Codex, Cursor, Claude app, Claude Code cloud | Not said, so no waiting. |
Details: Claude Code values, tool and detail fields
- Codex cloud rows have no
tool, since the cloud names no call. - Local Codex does not record pending approvals in its rollout.
permission promptandsandbox requestarepermission.input neededisanswer. Other values, such asdialog open, give nowaiting.- For a permission,
toolanddetailcome from the oldest tool call at the end of the transcript that has no result yet. toolis the name Claude Code writes, such asBash,Editormcp__claude_ai_Notion__notion-fetch.detailforBash: the first words of the command, about 30 characters, with…when cut. A leadingcd <folder> &&step is left out.detailforEdit,MultiEdit,Write,ReadandNotebookEdit: the file name.detailforWebFetch: the domain.detailfor an MCP tool: the server and action, such asNotion fetch. A server registered by id is named from its action, so the id never shows.- Other tools have no
detail. - A call whose line is larger than the transcript end the server reads gives no
tool. detailis left out when it, or the first 4 KB of the text it was read from, may hold a credential, by the rulereplyuses.
Chats archived in their app
A chat you archived in its own app shows under Archived, so un-archiving it in the app brings it back.
| Chat | Archived in its app |
|---|---|
| Codex thread, Cursor editor chat, Claude Cowork task | Listed as archived. |
| Claude chat | Listed as archived when it leaves the app's list. |
ChatGPT chat, cursor-agent chat | Not known: no archive flag. A normal row. |
A chat that waits for you or works still shows under Needs you or Working.Details: when an archive ends
dormant, and the web interface lists them by date.conversation-marks.json.cursor-agent keep no archive flag.count includes its archived chats.Details: Claude app chats and deleted chats
conversation-marks.json once full reads have missed it for 30 days. This holds only for Claude Code, Codex and cursor-agent, whose stores the server reads in full. See Marks.
Delete an archived chat
Remove a chat from this computer for good.
- Right-click a chat under Archived and choose Delete permanently….
- Read the confirmation. It names the chat and what goes.
- Confirm. Cancel, Escape or a click outside the question keeps the chat. The list then says how much space it freed.
| Chat | Can be deleted |
|---|---|
| Claude Code, on this computer | Yes |
| Codex | No. Close it, then run codex delete <id>. |
| Cursor editor chat, cloud session | No. Delete it where it lives. |
cursor-agent, any chat on Windows | Not yet. |
A chat that cannot be deleted says why when you choose the item.Details: when it is offered, refusals, limits
cursor-agent chats cannot be deleted yet.cursor-agent chat run in a terminal, and after a day for an editor panel or a background job.POST /api/conversations/delete lists what is removed and what stays, such as Claude Code's own prompt history.