[DOCS] Subagents docs missing `/agents` running count indicator
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/sub-agents
Section/Topic
Use the /agents command section
Current Documentation
The docs currently describe /agents like this:
The/agentscommand provides an interactive interface for managing subagents. Run/agentsto: View all available subagents (built-in, user, project, and plugin) Create new subagents with guided setup or Claude generation Edit existing subagent configuration and tool access Delete custom subagents * See which subagents are active when duplicates exist
The built-in commands reference also only says:
| /agents | Manage agent configurations |
There is no documentation explaining the new ● N running indicator shown in /agents next to agent types when live subagent instances of that type exist.
What's Wrong or Missing?
Claude Code v2.1.97 added a new /agents UI indicator: ● N running next to agent types with live subagent instances.
The current docs do not explain:
- what the indicator means
- whether the count is live
- whether it reflects currently running/backgrounded subagent instances
- why a user would see the indicator in
/agents
That leaves a new user-visible /agents behavior undocumented even though the page already describes the /agents interface.
Suggested Improvement
Add a bullet or short subsection under Use the /agents command explaining the running-instance indicator, for example:
/agentsalso shows a● N runningbadge next to agent types that currently have live subagent instances in the session. This count updates as subagents start and finish, helping you see which agent types are active right now.
If there are important scope details, document them too, such as whether the count includes background subagents only or all live subagent instances.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/sub-agents | 142-149 | /agents capabilities list omits the new running-count indicator |
| https://code.claude.com/docs/en/commands | 18 | /agents command reference is too brief to surface this new UI behavior |
Total scope: 2 pages affected
Source: Changelog v2.1.97
Changelog entry: Added ● N running indicator in /agents next to agent types with live subagent instances
Related current documentation that may need terminology alignment:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/sub-agents | 592 | The docs already describe running-status visibility in @-mention typeahead, but not the corresponding /agents running-count indicator |
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗