[DOCS] `claude agents` empty-state description in Troubleshooting is stale; v2.1.203 replaces the onboarding hint with the Needs input / Working / Completed sections (with descriptions)

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

The Troubleshooting entry "Agent view opens with no sessions" (currently around line 564), the "Organize the list" section that describes how sessions are grouped (around line 201), the introductory prose under "Monitor sessions with agent view" (around line 73), and the Version history table at the bottom of the page (which currently stops at v2.1.202 and has no v2.1.203 row).

Current Documentation

The Troubleshooting entry currently reads:

### Agent view opens with no sessions Before you dispatch your first session, agent view shows a short onboarding hint with example prompts in place of the session list. Type a prompt in the input at the bottom and press Enter to dispatch your first session.

The "Organize the list" section currently reads:

Agent view groups sessions so the ones that need input are at the top, with Ready for review and Needs input above Working and Completed. These group names don't map one-to-one to the [states](#read-session-state) above: a session moves to Ready for review when it has an open pull request, and Completed collects finished, failed, and stopped sessions together.

The "Read session state" table (around lines 111-118) describes each row icon but never describes the empty-state placeholder text that appears under each section heading when the section is empty.

The Version history table currently stops at v2.1.202 and has no v2.1.203 row.

What's Wrong or Missing?

A. The Troubleshooting entry no longer matches the empty-state behavior

The v2.1.203 changelog states:

Changed the empty claude agents view to always show the organized sections (Needs input / Working / Completed) with descriptions

After v2.1.203 the empty view is not "a short onboarding hint with example prompts in place of the session list" — it is the regular grouped section headers with a short description under each. The Troubleshooting entry still describes the old onboarding text path and never mentions the new section-with-description empty state, so a user reading the troubleshooting guide is told to expect behavior that no longer applies on a fresh install at v2.1.203 or later.

B. The "Organize the list" prose implies headers always correspond to sessions

The current text frames Needs input, Working, and Completed as group headers that contain sessions. After v2.1.203 those headers also appear with their descriptions when the section is empty, which is a meaningful reading change that the prose does not capture. A reader who skims the page learns the headers' order but never learns what each section's description says in the empty state, so they cannot predict what they will see on a freshly installed claude agents run.

C. The Version history table is missing the v2.1.203 row

The Version history table at the bottom of the page lists v2.1.202, v2.1.200, v2.1.199, v2.1.198, and earlier, but has no v2.1.203 row that records this change. Because this is a behavior change in the empty state — the visible layout users see on first run — the version history is the natural place to record it for someone scanning the page from the bottom up.

Suggested Improvement

Update the Troubleshooting entry to reflect the new empty state and add the v2.1.203 row to the Version history table. Suggested wording:

### Agent view opens with no sessions When there are no sessions to show, agent view still displays the same Needs input / Working / Completed section headers it uses for populated lists, with a short description under each header explaining what kinds of sessions will appear there. Type a prompt in the input at the bottom and press Enter to dispatch your first session.

Add the following row to the Version history table:

| v2.1.203 | {/ min-version: 2.1.203 /}The empty claude agents view always shows the Needs input / Working / Completed section headers with a short description under each, so the grouped layout is visible before the first session is dispatched. |

Optionally extend the "Organize the list" section with one sentence that covers the empty case:

When no sessions are listed, agent view still renders the Needs input, Working, and Completed headers with a one-line description under each so the layout is visible before the first dispatch.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/agent-view | Troubleshooting, "Organize the list", "Read session state", and Version history all touch the empty-state behavior |

Total scope: 1 page affected.

Related changelog entry (v2.1.203):

Changed the empty claude agents view to always show the organized sections (Needs input / Working / Completed) with descriptions