Use Agents View as a work queue

The one idea

Treat Agents View like a task board for local background sessions. You dispatch independent tasks from the input, watch rows grouped by state, use Space to peek or reply, and use Enter only when you need the whole transcript. The official docs describe Agents View as one screen for background sessions: what is running, what needs input, and what is done.

The operating loop

The main trap is thinking the bottom input is a follow-up box. It is not. A prompt entered there starts a new background session. To continue an existing task, select its row and peek or attach.

Your first run

1. Open from the right directory

   In the project you want the session to see, run claude agents. To scope the list to one project on supported versions, use claude agents --cwd <path>.

2. Dispatch a low-risk task

   Type a task and press Enter. For a first drill, use a read-only prompt:

   Summarize the current repo structure and tell me which commands look safe to run. Do not edit files.

3. Watch the row, not the transcript

   Rows are grouped so input-needed and review-ready sessions are easier to find. A row can be working, waiting for input, idle, completed, failed, or stopped. The summary tells you what changed recently.

4. Peek before attaching

   Select the row and press Space. The peek panel is usually enough: it shows recent output, questions, and pull request information. If the session asks a simple question, reply there.

5. Attach only for real steering

   Press Enter or Right Arrow to enter the full session. When you are done, press Left Arrow on an empty prompt to detach. Detaching leaves the background session running.

6. Preserve results before deleting

   If a session edited files, Claude may have isolated those edits in a git worktree under .claude/worktrees/. Commit, push, merge, or recover work you want before using Ctrl+X twice to delete a session.

Decision table

Practice: retrieve the essentials

Type the command or shortcut from memory, then check. This is deliberately small: durable recall matters more than rereading.

Primary source

• Read or skim the official page next: Manage multiple agents with agent view. Focus on Quick start, Monitor sessions, Dispatch new agents, Manage sessions from the shell, and Limitations.