Skip to content

[DOCS] Agent view version history omits the v2.1.199 change to PR-link row rendering #73690

Description

@coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

The "Version history" table at the bottom of agent-view.md, specifically the v2.1.199 row.

Current Documentation

The version history table lists only two v2.1.199 changes:

| v2.1.199 | {/* min-version: 2.1.199 */}A background session whose process exits before it finishes starting on a low-memory host shows possibly low memory — free some up and retry in its row status instead of only the bare exit reason. Backgrounding a session with or /background carries its /color over to the new row. |

The body of the same page, however, was updated to describe the new behavior on three separate occasions:

Run claude agents to open agent view. It takes over the full terminal and lists every session grouped by state, with pinned sessions and the ones that need you at the top. Each row shows the session's name, current activity, and how long ago it last changed.

Ready for review

The #N label that can appear at the right edge of a row is the pull request the session opened, not part of the state icon.

Pull request status

When a session opens a pull request, a #1234 label appears at the right edge of the row, linked to the pull request in terminals that support hyperlinks. The label persists when you send a follow-up to the session, so the pull request remains visible while the row reverts to live progress.

The changelog entry the version history table is supposed to summarize says:

claude agents session rows now show pull-request links as bare #N without the redundant "PR" label

What's Wrong or Missing?

A. Version history table omits a v2.1.199 change

The body of agent-view.md was updated in three places to describe the new bare-#N rendering, but the "Version history" row for v2.1.199 only mentions the low-memory message and /color carry-over. A reader scanning the version history has no way to learn from that table alone that the PR label on a row changed shape in v2.1.199, even though the change is described elsewhere on the same page.

B. Other related pages still describe the old format

interactive-mode.md (footer PR link, separate surface but same claude agents/terminal area) still says:

When working on a branch with an open pull request, Claude Code displays a clickable PR link in the footer, such as "PR #446".

That describes the footer PR link in an interactive session, not the agent view row label, so it is out of scope for this issue. Flagging it only so reviewers can confirm the agent-view change is the v2.1.199 one referenced in the changelog and not the footer text.

Suggested Improvement

Append the new behavior to the existing v2.1.199 row in the version history table on agent-view.md, alongside the low-memory and /color entries. Suggested text:

A session row that opened a pull request shows the PR as bare #N at the right edge instead of the redundant PR #N.

For example, the v2.1.199 cell becomes:

{/* min-version: 2.1.199 */}A background session whose process exits before it finishes starting on a low-memory host shows possibly low memory — free some up and retry in its row status instead of only the bare exit reason. Backgrounding a session with or /background carries its /color over to the new row. A session row that opened a pull request shows the PR as bare #N at the right edge instead of the redundant PR #N.

The body prose (Quick start example, "Read session state" callout, "Pull request status" section) is already correct and needs no change.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Page Context
https://code.claude.com/docs/en/agent-view Version history table for v2.1.199 omits the #N PR-label change; body prose is already correct

Total scope: 1 page affected (version history row only)

Source: Changelog v2.1.199 — claude agents session rows now show pull-request links as bare #N without the redundant "PR" label

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:agent-viewclaude agents TUI / --bg / FleetView / daemon bg sessionsarea:docsdocumentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions