Reference

Agents View Quick Reference

Use this when you already know the workflow and need the command, shortcut, or safety rule fast.

Primary source: Claude Code Agents View docs Related reference: Git worktrees Last checked: 2026-07-04

Core Loop

Openclaude agents DispatchType a task, press Enter MonitorRead group, icon, summary PeekSpace, reply, or choose AttachEnter for full session DetachLeft Arrow on empty prompt

Shell Commands

Command	Use when
`claude agents`	Open Agents View.
`claude agents --cwd <path>`	Show sessions started under one project directory.
`claude agents --json`	List live, working, and blocked background sessions as JSON.
`claude --bg "prompt"`	Start a background session directly from the shell.
`claude --agent <name> --bg "prompt"`	Run a named subagent as the main agent for that background session.
`claude --bg --name "name" "prompt"`	Give the row a readable name immediately.
`claude --bg --exec 'command'`	Run a shell command as a background job without invoking a model.
`claude attach <id>`	Open a background session in the current terminal.
`claude logs <id>`	Print recent output without opening Agents View.
`claude stop <id>`	Stop a background session.
`claude respawn <id>`	Restart a session with its conversation intact.
`claude rm <id>`	Remove a session from the list; keeps Claude-created worktrees with uncommitted changes.
`claude daemon status`	Inspect supervisor health and session counts.
`claude daemon stop --any --keep-workers`	Restart a stalled supervisor while keeping running sessions alive.

Agents View Shortcuts

Shortcut	Action
`Up` / `Down`	Move between rows.
`Space`	Open or close the peek panel.
`Enter`	Attach to selected row, or dispatch when the input has text.
`Shift+Enter`	Dispatch and attach immediately.
`Right Arrow`	Attach to the selected row.
`Left Arrow`	Detach from an attached session when the prompt is empty.
`Ctrl+S`	Switch grouping between state and directory.
`Ctrl+T`	Pin or unpin a session.
`Ctrl+R`	Rename a session.
`Ctrl+X`	Stop selected session; press again within two seconds to delete it.
`Shift+Up` / `Shift+Down`	Reorder selected session.
`Esc`	Close peek, clear input, or exit.
`?`	Show all shortcuts in context.

Filters

Input	Shows
`a:<name>`	Sessions running the named agent.
`s:<state>`	Sessions in a state such as `s:working` or `s:blocked`.
`#<number>` or PR URL	The session working on that pull request.
Any other URL	The session whose first prompt included that URL.

Use Peek When

You need the latest output, not the full transcript.
A row needs input and the answer is short.
You want to inspect PR links or the current blocker.

Use Attach When

You need full context.
You need to run normal Claude Code commands.
The session needs sustained steering.

Safety Rules

Check claude --version. Agents View requires Claude Code v2.1.139 or later, and some flags require newer versions.
Every prompt entered in the dispatch input starts a new session. To follow up with an existing session, peek or attach to that row.
Background sessions consume subscription quota independently. Many sessions in parallel spend quota faster.
Background sessions are local. Sleep preserves them; shutdown stops running sessions, which can appear failed afterward.
In a git repository, Claude-created background sessions isolate edits in .claude/worktrees/ before writing. Use the worktree reference before deleting useful work.
Do not delete a session that has useful uncommitted work. Commit, push, merge, or recover the worktree path first.
On macOS, background sessions may need separate permission to read Desktop, Documents, or Downloads.