Hand off tasks and track them in agent view

The steps

One step at a time. When a step’s check matches, tick it and the next one opens.

1. 01

   Step 1 of 4: Open agent view

   Start the screen that lists every background session.

   TerminalCopy

   Run: $ claude agents

   – What happens: In a folder you haven’t trusted yet, the trust prompt comes first.

   Check it worked

   Agent view fills the terminal: empty groups and an input at the bottom. Esc takes you back to the shell.

   If it didn’t work

   It prints your subagents and exits

   Run claude update. Still exits? Check disableAgentView and CLAUDE_CODE_DISABLE_AGENT_VIEW.

   It worked — next step Not yet
2. 02

   Step 2 of 4: Dispatch two tasks

   Each prompt you send starts its own background session.

   In Claude Code

   You type: › List every error message the quote command can print and the input that causes it

   You type: › Add a short Options section to README.md that explains --discount and --vat

   – What happens: Press Enter after each one. The second edits a file, so it moves into its own worktree first.

   Check it worked

   Two rows appear, each with a one-line summary that updates as the session works.

   It worked — next step Not yet Back
3. 03

   Step 3 of 4: Peek and reply

   Check a session without opening it, and answer if it waits on you.

   In order:

   1. You

      Select a row

      ↑ / ↓

   2. You

      Peek

      Space shows its latest output or question

   3. You

      Reply

      Type and press Enter

   4. You

      Attach

      Enter or → opens the full session

   Check it worked

   Peeking at the finished question shows its answer. A Needs input row shows its question.

   If it didn’t work

   Your reply doesn’t answer a permission prompt

   Permission prompts can’t be answered from peek. Attach with → and answer there.

   It worked — next step Not yet Back
4. 04

   Step 4 of 4: Review the result, then stop or delete

   Attach to the README session, read its report, and decide what to keep.

   Its recap and report say where the work is, such as a branch in its own worktree. Unless your CLAUDE.md says you handle git, it has committed there. ← on an empty prompt takes you back.

   Stop: Ctrl+X once

   • Ends the session
   • The row moves to Completed, with a grey icon

   Delete: Ctrl+X twice

   • Removes the row; the transcript stays for claude --resume
   • Removes the worktree Claude made, uncommitted changes included
   • Asks again before discarding unpushed commits

   Check it worked

   You found the README change on its branch, and the list shows only the sessions you kept.

   It worked — finish Not yet Back