Confusing terminology in /agents command - says '20 agents' when they're just definitions

Resolved 💬 3 comments Opened Sep 24, 2025 by Teo-Asinari Closed Jan 9, 2026

Problem

The /agents command displays "20 agents" which is confusing because it sounds like 20 agents are actively running processes. In reality, these are just agent definition files (.md templates) that are available for use.

Current behavior

  • Shows: "20 agents"
  • User interpretation: 20 agents are running/active
  • Reality: 20 agent definitions are available to use

Suggested improvement

Change the wording to be more precise:

  • "20 agent definitions available"
  • "20 agent templates"
  • "20 agents available"

This would eliminate confusion about whether agents are actively running vs just being available for use.

Impact

This terminology confusion causes users to think they have runaway processes when they just have template files in their ~/.claude/agents directory.

View original on GitHub ↗

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