/agents

Manages subagent configurations.

/agents revolves around subagents: standalone configurations that Claude delegates subtasks to. Since version 2.1.198, the command no longer opens its own interface, but instead only shows a hint to ask Claude directly to create or manage subagents, or to edit .claude/agents/ or ~/.claude/agents/ directly. Up through version 2.1.197, /agents opened an interactive interface with a tab for running subagents and a tab for creating, editing, and deleting definitions. The subagent files themselves, their frontmatter fields, and the two storage locations haven't changed with this switch: project subagents live in .claude/agents/ and are only available in the respective repository, personal subagents in ~/.claude/agents/ are available across projects. Newly created files are automatically detected within a few seconds, without needing a restart.

🔄 THE SAME TASK (“MANAGE SUBAGENTS/CUSTOM AGENTS”) ON OTHER PLATFORMS

Antigravity CLI: /agents

Compare all 28 tasks →

✅ WHEN TO USE IT?

Asking Claude to create a new subagent configuration

/agents, then: "Create a personal subagent for database migrations in ~/.claude/agents/ for me."

Reviewing existing subagent definitions before adjusting them in the current project

/agents, to get pointed to .claude/agents/ or ~/.claude/agents/, then open the markdown file directly in the editor.

⛔ WHEN NOT TO?

Expecting an interactive management interface with a Running/Library tab

from version 2.1.198 on, /agents only shows a hint text instead of the earlier interactive UI

Better: edit .claude/agents/ or ~/.claude/agents/ directly in the editor, or use version 2.1.197 or older

Wanting to enforce a subagent team- or organization-wide

subagents created via .claude/agents/ or ~/.claude/agents/ are project or personal subagents, not a binding requirement for others

Better: have organization admins roll out managed subagents via the managed settings directory variant of .claude/agents/

SOURCES

Claude Code docs (official) ↗ code.claude.com

MORE COMMANDS · Claude Code

/autofix-pr /background /batch /branch /btw /cd /chrome /claude-api /clear /code-review /color /compact

All commands · Claude Code →

Share:𝕏 in 💬