Manage multiple agents with agent view changedagent-view
Nearest release: v2.1.291, published 2 hours after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 6 Oct 2026 01:16 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 6 Oct 2026 01:37 UTC.
Upstream edited
Recorded here
Lines+15added
Lines−12removed
From line
114
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits44to this page, all time
The whole hunk
from line 114, old and new numbered
/
from line 114
114114
115115Working
116116 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m
117 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m
117 ✢ playtest level 3 all checkpoints cleared ×12 in 4m
118118
119119Completed
120 ✻ title screen result: menu, options, and credits done 9m
121 ∙ sound effects result: 14 SFX exported to assets/audio 4h
120 ✻ title screen menu, options, and credits done 9m
121 ∙ sound effects 14 SFX exported to assets/audio 4h
122122 … 6 more
123123```
124124
from line 135
135135| Failed | Red | The task ended with an error |
136136| Stopped | Grey | You stopped the session with `Ctrl+X` or `claude stop`, [its process was ended from outside Claude Code](#the-supervisor-process), or [it ended while the background service was off](#sessions-show-as-failed-after-shutdown) |
137137
138Separately, the icon's shape shows whether the underlying process is running:
138Separately, the icon's shape has its own meaning:
139139
140140| Shape | What it means |
141141| :- | :- |
142| `✻` or animated `✽` | The session process is alive and replies immediately |
142| `✻` or animated `✽` | The session process is running, or the session needs your input |
143143| `∙` | The process has exited. You can still peek at the row, and when you reply or attach, Claude restarts from where it left off |
144144| `✢` | A [`/loop`](/docs/en/scheduled-tasks) session sleeping between iterations. The row shows its run count and a countdown |
145145
from line 278
278278
279279### Organize the list
280280
281Agent view groups sessions so the ones that need input are at the top, with `Ready for review` and `Needs input` above `Working` and `Completed`. These group names don't map one-to-one to the [states](#read-session-state) above: a session moves to `Ready for review` when it has an open pull request, and `Completed` collects finished, failed, and stopped sessions together.
281Agent view groups sessions so the ones that need input are at the top, with `Ready for review` and `Needs input` above `Working` and `Completed`. These group names don't map one-to-one to the [states](#read-session-state) above: a session moves to `Ready for review` when it has an open pull request that needs review or has failing checks, and `Completed` collects finished, failed, and stopped sessions together.
282282
283283Press `Ctrl+S` to group by directory instead. Your choice persists across runs.
284284
from line 304
304304* the view was started with [`--safe-mode`](/docs/en/cli-reference#cli-flags)
305305* the view was opened with a flag such as `--permission-mode` or `--settings`
306306
307Completed sessions that don't fit on screen fold into a `… N more` row. Failures and sessions with an open pull request always stay visible. The `Completed` group fills the vertical space left after the live groups, and on a short terminal the header compacts to a single summary line so sessions that are working or need input stay visible.
307Completed sessions that don't fit on screen fold into a `… N more` row. The `Completed` group fills the vertical space left after the live groups, and on a short terminal the header compacts to a single summary line so sessions that are working or need input stay visible.
308308
309309### Filter sessions
310310
from line 325
325325
326326### Keyboard shortcuts
327327
328Press `?` in agent view to see every shortcut in context. The table below summarizes them.
328Press `?` in agent view to see shortcuts in context. The table below summarizes them.
329329
330330| Shortcut | Action |
331331| :- | :- |
from line 350
350350| `Shift+↑` / `Shift+↓` | Reorder the selected session |
351351| `Esc` | Close the peek panel, clear the input, or exit. When you opened agent view by backgrounding your session with `←`, the final `Esc` returns to that conversation instead of exiting. With [vim editor mode](/docs/en/interactive-mode#vim-editor-mode) on, pressing `Esc` in the input switches from INSERT to NORMAL mode and keeps your text, as in the main prompt |
352352| `Ctrl+C` | Clear the input; press twice to exit |
353| `?` | Show all shortcuts |
353| `?` | Show shortcuts |
354354
355355The shortcuts that have an action in the [`Agents` context](/docs/en/keybindings#agents-actions) follow your [`keybindings.json`](/docs/en/keybindings). So does `Ctrl+G`, through the `Chat` context's `chat:externalEditor` binding.
356356
from line 554
554554
555555When the hook fails in a directory that isn't a git repository, Claude skips isolation for that directory and edits the working directory in place. Inside a git repository, a session that Claude moves into a worktree before editing can't edit files in the shared checkout until that move happens.
556556
557To find a session's worktree path, peek the session or attach and check its working directory.
557To find a session's worktree path, attach and check its working directory.
558558
559559A [subagent](/docs/en/sub-agents) the background session spawns inherits the session's working directory. Once the session is in a worktree, the subagent's file edits land in that worktree rather than in your working copy. To give a subagent its own separate worktree instead, set [`isolation: worktree`](/docs/en/sub-agents#supported-frontmatter-fields) in its frontmatter or pass `isolation: "worktree"` when spawning it.
560560
from line 742
742742| `claude agents` | Open agent view |
743743| `claude agents --cwd <path>` | Open agent view scoped to sessions started under `<path>` |
744744| `claude agents --json` | Print sessions as a JSON array and exit. See [List sessions as JSON](#list-sessions-as-json) |
745| `claude attach <id>` | Attach to a session in this terminal |
746| `claude logs <id>` | Print the session's recent output |
745| `claude attach <id\|name>` | Attach to a session in this terminal |
746| `claude logs <id\|name>` | Print the session's recent output |
747747| `claude stop <id>` | Stop a session. Also accepts `claude kill` |
748748| `claude respawn <id>` | Restart a session, running or stopped, e.g. to pick up an updated Claude Code binary. The restarted session resumes its saved conversation; when none is on disk, it runs its original prompt again as a new conversation |
749749| `claude respawn --all` | Restart every running session, e.g. to move all sessions onto an updated Claude Code binary at once |
from line 753
753753| `claude daemon status` | Print the [supervisor's](#the-supervisor-process) state, version, socket directory, and worker count |
754754| `claude daemon stop --any` | Stop the supervisor process and the background sessions it hosts. Pass `--keep-workers` to leave background sessions running so the next supervisor reconnects to them. The next `claude agents` or `claude --bg` starts a fresh supervisor |
755755
756`claude attach` and `claude logs` can take part of a running session's name in place of the ID, as in `claude logs "auth refactor"`. Passing a name requires Claude Code v2.1.290 or later.
757
756758### List sessions as JSON
757759
758760`claude agents --json` prints active sessions as a JSON array and exits: every live session, plus background sessions that are still working or blocked even when their process has exited. Add `--all` to also include completed background sessions, and `--cwd <path>` to limit the list to sessions started under that directory.
from line 975
973975
974976| Version | Change |
975977| - | - |
978| v2.1.290 | [`claude attach` and `claude logs`](#manage-sessions-from-the-shell) can take part of a running session's name in place of the ID. |
976979| v2.1.288 | `Ctrl+F` finds sessions by name, and `Alt+↑` / `Alt+↓` jump between group headers. Both, and `Ctrl+R`, can be [rebound](/docs/en/keybindings#agents-actions). |
977980| v2.1.287 | The [`n:<text>` filter](#filter-sessions) finds sessions by name or first prompt. While any filter is active, groups you collapsed expand to show their matches and the first match is selected, so `Enter` opens it. |
978981| v2.1.287 | A command sent as a [peek reply](#peek-and-reply) runs when the session's current turn ends, including the commands that run as soon as you type them at a session's own prompt. A reply that is exactly `/stop` stops the session at once. |
No line in this hunk matches that.