Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] Subagents docs missing `/agents` running count indicator [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#45467•Fetched 2026-04-09 08:04:45
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×3
RAW_BUFFERClick to expand / collapse

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:

PageLine(s)Context
https://code.claude.com/docs/en/sub-agents142-149/agents capabilities list omits the new running-count indicator
https://code.claude.com/docs/en/commands18/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:

PageLine(s)Context
https://code.claude.com/docs/en/sub-agents592The docs already describe running-status visibility in @-mention typeahead, but not the corresponding /agents running-count indicator

extent analysis

TL;DR

Add documentation for the ● N running indicator in the /agents section to explain its meaning and behavior.

Guidance

  • Update the Use the /agents command section to include a bullet or short subsection explaining the ● N running indicator, its purpose, and how it updates.
  • Consider adding scope details, such as whether the count includes background subagents only or all live subagent instances.
  • Review related documentation, such as the /agents command reference and the @-mention typeahead section, to ensure terminology alignment.
  • Verify that the updated documentation accurately reflects the behavior of the ● N running indicator in the /agents UI.

Example

The suggested improvement provides an example of how the documentation could be updated:

/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.

Notes

The impact of this issue is medium, as it makes the feature difficult to understand. The suggested improvement should be applied to the affected pages, specifically the /agents capabilities list and the /agents command reference.

Recommendation

Apply the suggested improvement to add documentation for the ● N running indicator, as it provides clarity on the feature's behavior and helps users understand the /agents UI.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#prompt formatting#chain error#conversation history#tool integration#LLM response

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING