[FEATURE] color field in agent frontmatter for consistent team UI identification
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Feature request
When working with multi-agent teams, each teammate is assigned a random display color in the
UI. The /agents interactive wizard lets you pick a color at creation time, but agent
definition files (.claude/agents/*.md) have no color field in the frontmatter.
Problem
- Colors are non-deterministic when agents are spawned programmatically via the Task tool
- When the same agent file is reused across sessions, it gets a different color each time,
making it harder to visually track which agent is which at a glance
- There's no way to establish a consistent color convention per agent role (e.g. "gsheet
queries are always blue")
Proposed Solution
Add an optional color field to the agent frontmatter:
---
name: gsheet-expert
description: Queries Google Sheets CRA staffing data.
color: blue
tools: Read, Bash
---
Accepted values could mirror the colors already available in the /agents wizard UI.
Alternative Solutions
_No response_
Priority
Medium - Would be very helpful
Feature Category
CLI commands and flags
Use Case Example
_No response_
Additional Context
Why it matters
In team workflows with 3+ agents running in parallel, color is the primary visual signal for
identifying who sent what. Making it stable and file-defined would make multi-agent sessions
significantly easier to follow.
Workaround today
None — color must be set interactively via /agents and doesn't persist to the .md file.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗