[DOCS] Agent view docs omit `claude agents --cwd <path>` and still describe the session list as global

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

Monitor sessions with agent view and Manage sessions from the shell

Current Documentation

The docs currently say:

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. The list shows every background session you've started, across all your projects. A session working in one repository and another in a different worktree both appear here, regardless of which directory you opened agent view from. | claude agents | Open agent view |

What's Wrong or Missing?

The v2.1.141 release added claude agents --cwd <path> to scope the session list to a directory, but the current documentation still describes claude agents as an all-projects view and does not document the new --cwd <path> option.

As written, the docs tell readers that agent view shows sessions "across all your projects" regardless of directory, which makes the new directory-scoped behavior undiscoverable and suggests that scoped session filtering is unavailable.

Suggested Improvement

Update the agent view page to explain both behaviors:

• claude agents shows the full background-session list.
• claude agents --cwd <path> scopes the list to sessions for a specific directory.

Add a short example near the existing shell commands, for example:

claude agents --cwd ~/work/repo

Also add a CLI reference entry for --cwd <path> under the claude agents command or CLI flags so users can discover the scoped-list option from the command reference.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 73-75, 302-314 | Says claude agents lists sessions across all projects and shows only the unscoped shell command |
| https://code.claude.com/docs/en/cli-reference | 27, 43-97 | Documents claude agents but does not mention --cwd <path> or directory-scoped session listing |

Total scope: 2 pages affected

This appears to be a docs gap for functionality introduced in v2.1.141.