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:

  1. By name pattern in settings.json:
{
  "agentColors": {
    "dev*": "green",
    "bug*": "red",
    "sec*": "yellow",
    "qa*": "cyan",
    "comp*": "magenta"
  }
}
  1. Or at spawn time via an optional color parameter 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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗