One change
Manage multiple agents with agent view
agent-view
Nearest release: v2.1.240, published 7 hours after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
agent-view Changed · +21 / -20 lines
from line 32
If you haven't yet accepted the [workspace trust dialog](/docs/en/permissions#project-allow-rules-and-workspace-trust) for the directory, Claude Code shows it before agent view opens, the same dialog `claude` shows. Accept to save trust for the workspace and continue. If you decline, Claude Code exits without opening agent view. - Agent view opens with an input at the bottom and a table that fills in as sessions start. Press `Esc` at any time to return to your shell; if you opened agent view by backgrounding a session with `←`, `Esc` returns to that conversation instead. Your sessions keep running while you're away and reappear the next time you open agent view. + Agent view opens with an input at the bottom and a table that fills in as sessions start. Press `Esc` to return to your shell; if you opened agent view by backgrounding a session with `←`, `Esc` returns to that conversation instead. Your sessions keep running while you're away and reappear the next time you open agent view. </Step> <Step title="Dispatch a session">
from line 281
Press `?` in agent view to see every shortcut in context. The table below summarizes them. -| Shortcut | Action | -| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `↑` / `↓` | Move between rows | -| `Enter` | Attach to the selected session, or dispatch if there's text in the input | -| `Space` | Open or close the peek panel for the selected session | -| `Shift+Enter` | Dispatch and attach immediately | -| `→` | Attach to the selected session | -| `Alt+1`..`Alt+9` | Attach to session 1–9 in the focused session's directory | -| `Tab` | On an empty input, browse all subagents. Otherwise apply the highlighted suggestion | -| `Ctrl+S` | Switch grouping between state and directory | -| `Ctrl+T` | Pin or unpin the selected session | -| `Ctrl+R` | Rename the selected session | -| `Ctrl+G` | Open the dispatch prompt in your `$VISUAL` or `$EDITOR` | -| `Ctrl+J` | Insert a newline in the dispatch input | -| `Ctrl+X` | Stop the session; press again within two seconds to delete it | -| `Shift+↑` / `Shift+↓` | Reorder the selected session | -| `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 | -| `Ctrl+C` | Clear the input; press twice to exit | -| `?` | Show all shortcuts | +| Shortcut | Action | +| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `↑` / `↓` | Move between rows | +| `Enter` | Attach to the selected session, or dispatch if there's text in the input | +| `Space` | Open or close the peek panel for the selected session | +| `Shift+Enter` | Dispatch and attach immediately | +| `→` | Attach to the selected session | +| `Alt+1`..`Alt+9` | Attach to session 1–9 in the focused session's directory | +| `Tab` | On an empty input, browse all subagents. Otherwise apply the highlighted suggestion | +| `Ctrl+S` | Switch grouping between state and directory | +| `Ctrl+T` | Pin or unpin the selected session | +| `Ctrl+R` | Rename the selected session | +| `Ctrl+G` | Open the dispatch prompt in your `$VISUAL` or `$EDITOR` | +| `Ctrl+J` | Insert a newline in the dispatch input | +| `Ctrl+X` | Stop the session; press again within two seconds to delete it | +| `Shift+↑` / `Shift+↓` | Reorder the selected session | +| `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 | +| `Ctrl+C` | Clear the input; press twice to exit | +| `?` | Show all shortcuts | ## Dispatch new agents
from line 850
| Version | Change | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| v2.1.239 | With [vim editor mode](/docs/en/interactive-mode#vim-editor-mode) on, pressing `Esc` in agent view's input switches from INSERT to NORMAL mode and keeps your text, matching the main prompt; in NORMAL mode with text still in the input, pressing `Esc` clears it, and pressing `Esc` on an empty input exits, as the [`Esc` shortcut](#keyboard-shortcuts) describes. Before this release, `Esc` cleared the input. | | v2.1.233 | For a session linked to a GitLab merge request, Claude Code writes the row's label in GitLab's `!1234` reference syntax. You can also paste the merge request's URL into the [dispatch input](#filter-sessions) to select that session. Before this release, the label rendered as `#1234`, and a pasted merge request URL matched a session only when its first prompt contained the URL. | | v2.1.227 | [Deleting a session](#what-deleting-a-session-removes) keeps the session and its worktree while another live Claude Code session is running inside that worktree directory. Agent view shows `not deleted` on the row and the reason in the footer, and `claude rm` prints `kept <id>` with the reason, which names the other session's process ID. Before this release, deleting the session removed the worktree while the other session was still working in it. | | v2.1.225 | `claude agents` in a directory you haven't trusted shows the same [workspace trust dialog](/docs/en/permissions#project-allow-rules-and-workspace-trust) that `claude` shows on startup, before agent view opens. Accepting saves trust for that workspace; declining exits without opening agent view. Before this release, `claude agents` opened without asking, so sessions you dispatched from it ran in a directory you'd never been asked to trust.<br /><br />With the list grouped by directory, hovering the mouse over a row highlights it without changing the [dispatch target](#dispatch-to-a-specific-directory); selecting a row with the arrow keys or a click still changes the target. Before this release, moving the mouse over a session in another project silently changed the directory the next dispatched session started in. |