[DOCS] Subagents docs missing `/agents` running count indicator

Open 💬 3 comments Opened Apr 8, 2026 by coygeek

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 /agents command provides an interactive interface for managing subagents. Run /agents to: 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:

/agents also shows a ● N running badge 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 |

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗