[FEATURE] color field in agent frontmatter for consistent team UI identification

Resolved 💬 1 comment Opened Feb 23, 2026 by antoinethiga Closed Feb 23, 2026

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.

View original on GitHub ↗

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