Feature: customizable agent/teammate name colors in multi-agent output
Resolved 💬 1 comment Opened Apr 16, 2026 by bish-x Closed May 25, 2026
Problem
When using multi-agent orchestration (Agent Teams, parallel subagents), Claude Code automatically assigns colors to teammate names (@dev-1, @bug-rev-1, @qa-1, etc.) in the terminal output. These colors are auto-assigned and cannot be configured.
In complex pipelines with 5+ concurrent agents, the random color assignment makes it harder to visually track which agent is doing what — especially across multiple runs where the same logical role gets a different color each time.
Proposed solution
Allow users to configure agent name colors, either:
- By name pattern in
settings.json:
{
"agentColors": {
"dev*": "green",
"bug*": "red",
"sec*": "yellow",
"qa*": "cyan",
"comp*": "magenta"
}
}
- Or at spawn time via an optional
colorparameter in the Agent tool / TeamCreate.
Why this matters
- Visual consistency — same role = same color across sessions. Easier to build muscle memory when scanning multi-agent output.
- Pipeline readability — in a Lead → Dev → 3 Reviewers → QA pipeline, color-coding by role (green=dev, red=bugs, yellow=security) makes the flow instantly scannable.
- Accessibility — users with color vision deficiency could pick distinguishable color pairs that work for them.
Current workaround
None. Colors are assigned internally and not exposed to configuration.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗