[DOCS] CLI reference missing `claude agents` command documentation

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/cli-reference

https://code.claude.com/docs/en/sub-agents

Section/Topic

CLI commands table in CLI reference and subagent management command coverage.

Current Documentation

The CLI command table currently documents commands such as:

| claude | Start interactive REPL | | claude update | Update to latest version | | claude mcp | Configure Model Context Protocol (MCP) servers |

The docs also cover:

| --agents | Define custom subagents dynamically via JSON |

And subagent docs focus on slash command workflow:

The /agents command provides an interactive interface for managing subagents.

What's Wrong or Missing?

Claude Code v2.1.50 added a claude agents CLI command to list configured agents, but cli-reference and related subagent docs do not document this command.

This creates a discoverability gap between:

• interactive /agents usage,
• --agents inline JSON configuration,
• and the new standalone listing command.

Suggested Improvement

Add claude agents to https://code.claude.com/docs/en/cli-reference with:

• command purpose (list configured agents),
• usage examples (claude agents),
• output format notes (human-readable vs machine-readable, if applicable),
• relationship to /agents and --agents.

Also add a short cross-reference in subagent docs so users can discover both interactive and CLI listing workflows.

Impact

Medium - Makes feature difficult to understand

Additional Context

Source: Claude Code release v2.1.50
Release entry: "Added claude agents CLI command to list all configured agents"

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/cli-reference | 9-22, 31 | Command table omits claude agents; only --agents flag is documented |
| https://code.claude.com/docs/en/sub-agents | 137-145 | Documents /agents interactive command but not claude agents |

Total scope: 2 pages affected