[DOCS] [Agent view] Row format and peek panel content updated in v2.1.205: colored state word + classifier-written headline replace raw tool call text, and the peek opens with full status including the exact ask for blocked sessions

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

• The example output block in the "Monitor sessions with agent view" section (around lines 87-105) that shows row contents like Write assets/sprites/clawd-walk.png and Edit src/physics/CollisionSystem.ts.
• The "Read session state" subsection (around lines 107-130) that describes each row's icon, animation, and color, but never mentions the row's colored state word.
• The "Row summaries" subsection (around lines 140-146) that describes the one-line summary, but does not say the row no longer shows raw tool call text.
• The "Peek and reply" subsection (around lines 165-175) that describes what the peek panel shows, but does not say the peek now opens with the full status and surfaces the exact ask for blocked sessions.
• The "Version history" table at the bottom of the page (currently stops at v2.1.203).

Current Documentation

The example output block in the "Monitor sessions with agent view" section currently shows rows whose headline text is a raw tool call (Write ... / Edit ... / Opened PR with ...) and the session state is implied by the icon and section header rather than rendered as a colored state word:

```text theme={null}
Pinned
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

Ready for review
∙ jump physics Opened PR with collision fix #2048 2h

Needs input
✻ power-up design needs input: double jump or wall climb? 1m

Working
✽ collision detection Edit src/physics/CollisionSystem.ts 2m
✢ playtest level 3 run 12 · all checkpoints cleared in 4m

Completed
✻ title screen result: menu, options, and credits done 9m
∙ sound effects result: 14 SFX exported to assets/audio 4h
… 6 more

The "Row summaries" subsection currently says:

> The one-line summary in each row is generated by a [Haiku-class model](https://code.claude.com/docs/en/model-config) so the row can tell you what the session is doing, what it needs, or what it produced without opening the transcript. While a session is actively working, the summary refreshes at most once every 15 seconds, plus once when each turn ends.

The "Read session state" table currently defines state purely through icon shape and animation; it never introduces a "colored state word" or any inline text that names the state:

> | State       | Icon shows as | What it means                                                            |
> | :---------- | :------------ | :----------------------------------------------------------------------- |
> | Working     | Animated      | Claude is actively running tools or generating a response                |
> | Needs input | Yellow        | Claude is waiting on a specific question or permission decision from you |
> | Idle        | Dimmed        | The session has nothing to do and is ready for your next prompt          |
> | Completed   | Green         | The task finished successfully                                           |
> | Failed      | Red           | The task ended with an error                                             |
> | Stopped     | Grey          | The session was stopped with `Ctrl+X` or `claude stop`                   |

The "Peek and reply" subsection currently says:

> Press `Space` on a selected row to open the peek panel. It shows what the session needs from you, its most recent output, and any pull requests it opened. Most of the time this is enough, and you never need to open the full transcript.

The "Version history" table at the bottom of the page currently lists v2.1.203 as the most recent row and has no entry for v2.1.205:

> | v2.1.203 | {/* min-version: 2.1.203 */}A gateway `ANTHROPIC_BASE_URL` exported in the dispatching shell reaches the sessions dispatched from it into that same directory when the supervisor shares that gateway environment, instead of being dropped while the API key exported alongside it was kept. The dispatching shell's `PATH` is applied to each session's worker. Pressing `←` while subagents are running waits for them instead of restarting them after ten seconds. The empty list always shows the section headers with a description under each. Typing `@` in the dispatch input also lists the launch repository's registered git worktrees that live inside its directory tree. An effort inherited from the `effortLevel` setting follows later edits to that setting instead of being fixed at dispatch. Opening a stopped session whose conversation is already open in another running session is refused with a message instead of failing the row. A command that isn't available in agent view leaves the typed text in the input. A `WorktreeCreate` hook that fails outside a git repository no longer blocks the session from editing files. |

### What's Wrong or Missing?

The v2.1.205 changelog entry records the change clearly:

> Improved agent view: rows now show a colored state word and a classifier-written headline instead of raw tool call text, and the peek opens with full status including the exact ask for blocked sessions

The current `agent-view.md` page predates this change and never reflects any of its three pieces.

### A. The example output still shows raw tool call text instead of a classifier-written headline

The example output block right above the "Read session state" heading shows each working row's headline as the raw tool name plus target path (`Write assets/sprites/clawd-walk.png`, `Edit src/physics/CollisionSystem.ts`), with the session state left implicit in the section header (`Working`, `Completed`, etc.). After v2.1.205 the row instead renders the state as a colored inline word (e.g. a colored `Working` or `Needs input` label) followed by a one-line classifier-written headline rather than the tool call. The example block is the first concrete picture a reader sees of what an agent view row looks like, so leaving it on the old format actively misrepresents the current behavior.

### B. The "Row summaries" subsection still describes only the one-line summary, not the colored state word or the swap from raw tool call text

The "Row summaries" subsection acknowledges that a Haiku-class model produces the one-line summary, but it never says (a) that v2.1.205 inserts a colored state word before that summary, or (b) that the previous raw tool call text (the `Write ...` / `Edit ...` pattern visible in the example block) has been replaced by the classifier-written headline. Readers cross-referencing the section with the example block will not learn that the change exists at all.

### C. The "Read session state" subsection does not describe the colored state word

The state legend maps each state to an icon (shape and animation) and describes what the state means in prose, but it never names the colored state word that now appears in the row itself. The two surfaces (icon and state word) carry overlapping information, so a reader who only consults the legend will not know there is now a text label for the state, what color it uses, or how it interacts with the existing animation/icon.

### D. The "Peek and reply" subsection does not describe the new peek content (full status including the exact ask for blocked sessions)

The peek panel description says it "shows what the session needs from you, its most recent output, and any pull requests it opened." The v2.1.205 change is that the peek opens with the full status of the session and, for blocked sessions, surfaces the exact ask (the specific question or decision the session is waiting on) directly in that opening view. The current prose is consistent with the old "what the session needs from you" behavior and does not call out the full-status opening or the "exact ask" wording for blocked sessions, so a reader following the docs will not know that the peek now leads with the exact question on a blocked session rather than mixing it into the most-recent-output view.

### E. The Version history table stops at v2.1.203 and has no row for v2.1.205

The version-history table at the bottom of the page is the canonical place a reader learns that something changed between versions. The table currently lists v2.1.203, v2.1.202, v2.1.200, and earlier rows. There is no row for v2.1.205 (and none for v2.1.204, which is a one-line fix from the changelog and may be folded into the v2.1.205 row or its own row). The row-format and peek-content improvements from v2.1.205 therefore do not appear in the version history at all.

### Suggested Improvement

### A. Update the example output block to show the colored state word and classifier-written headline

**Before** (current):

```text theme={null}
Pinned
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

Needs input
  ✻ power-up design           needs input: double jump or wall climb?       1m

Working
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

After (illustrative — the headline is classifier-written, and each row carries a colored state word):

```text theme={null}
Pinned
✽ clawd walk cycle Working Drawing the four-frame walk cycle 3m

Ready for review
∙ jump physics Review Collision fix pushed to #2048 2h

Needs input
✻ power-up design Needs input Pick the wall-climb variant 1m

Working
✽ collision detection Working Tuning the response curves 2m
✢ playtest level 3 Working All checkpoints cleared in 4m

Completed
✻ title screen Completed Menu, options, and credits done 9m
∙ sound effects Completed 14 SFX exported to assets/audio 4h
… 6 more

Use the exact wording Claude Code renders in your terminal so a reader can match the example to what they see on screen.

### B. Extend the "Row summaries" subsection to describe the colored state word

**Before:**

> The one-line summary in each row is generated by a [Haiku-class model](https://code.claude.com/docs/en/model-config) so the row can tell you what the session is doing, what it needs, or what it produced without opening the transcript. While a session is actively working, the summary refreshes at most once every 15 seconds, plus once when each turn ends.

**After:**

> The one-line summary in each row is generated by a [Haiku-class model](https://code.claude.com/docs/en/model-config) so the row can tell you what the session is doing, what it needs, or what it produced without opening the transcript. While a session is actively working, the summary refreshes at most once every 15 seconds, plus once when each turn ends. {/* min-version: 2.1.205 */}As of v2.1.205 the row begins with a colored state word (`Working`, `Needs input`, `Review`, `Completed`, and so on) followed by a classifier-written headline. Earlier versions showed the raw tool call instead — for example `Edit src/physics/CollisionSystem.ts` — without a state word.

### C. Add a colored state word row to the "Read session state" subsection

Add a short paragraph immediately after the state legend table that names the colored state word and links it back to the legend:

> {/* min-version: 2.1.205 */}As of v2.1.205, the row's headline begins with the state word itself, colored to match the icon: `Working` (animated), `Needs input` (yellow), `Review` (purple), `Idle` (dimmed), `Completed` (green), `Failed` (red), `Stopped` (grey). The icon and animation are unchanged; the colored state word is an additional inline label, not a replacement.

### D. Update the "Peek and reply" subsection to describe the new peek content

**Before:**

> Press `Space` on a selected row to open the peek panel. It shows what the session needs from you, its most recent output, and any pull requests it opened. Most of the time this is enough, and you never need to open the full transcript.

**After:**

> Press `Space` on a selected row to open the peek panel. {/* min-version: 2.1.205 */}As of v2.1.205 the peek opens with the full status of the session: the colored state word, the classifier-written headline, the longest-running parallel work item if any, and — when the session is blocked — the exact ask, the specific question or decision the session is waiting on, in place of the generic "what the session needs from you" view. Pull requests the session opened are listed alongside the rest. Most of the time this is enough, and you never need to open the full transcript.

### E. Add a v2.1.205 row to the Version history table

Insert a new row above the existing v2.1.203 row in the Version history table:

> | v2.1.205 | {/* min-version: 2.1.205 */}Each row now begins with a colored state word (`Working`, `Needs input`, `Review`, `Completed`, etc.) followed by a classifier-written headline rather than the raw tool call text shown in earlier versions. The peek panel opens with the full session status and, for blocked sessions, surfaces the exact ask the session is waiting on. |

If a v2.1.204 row is also desired (the v2.1.204 changelog only lists one SessionStart-hook fix), add a one-line row above v2.1.205 describing that fix.

### Impact

Medium - Makes feature difficult to understand

### Additional Context

**Affected Pages:**

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 87-105 (example block), 107-130 (Read session state), 140-146 (Row summaries), 165-175 (Peek and reply), 678-695 (Version history) | Row format, peek content, and Version history table all predate the v2.1.205 change |

**Total scope:** 1 page affected.

The change ships in Claude Code v2.1.205 (released alongside the rest of the v2.1.205 batch on the changelog).