Skip to main content
Claude HUD uses five named color roles. Each role maps to a semantic purpose and is applied consistently across the HUD. You can override any role in ~/.claude/plugins/claude-hud/config.json under the colors key.

​
Color roles

RoleAffectsDefault
colors.contextContext bar fill and context percentage textgreen
colors.usageUsage bar fill and usage percentage below the warning thresholdbrightBlue
colors.warningContext bar and text at warning-level thresholds (70–85%)yellow
colors.usageWarningUsage bar and percentage when usage is near the thresholdbrightMagenta
colors.criticalContext bar and text above the critical threshold (>85%), and when a limit is reachedred

​
Supported color values

Each role accepts one of three formats: Named color — one of the built-in names: 
red  green  yellow  magenta  cyan  brightBlue  brightMagenta
256-color index — an integer from 0 to 255: 
{ "colors": { "context": 39 } }
Hex color — a six-digit hex string prefixed with #: 
{ "colors": { "context": "#00afff" } }
Hex and 256-color index values require a terminal that supports true color or 256-color output. Named colors work in all terminals.

​
Default color configuration

{
  "colors": {
    "context": "green",
    "usage": "brightBlue",
    "warning": "yellow",
    "usageWarning": "brightMagenta",
    "critical": "red"
  }
}

​
Example: custom palette

This example uses cyan for both the context and usage bars, and magenta for the usage warning: 
{
  "colors": {
    "context": "cyan",
    "usage": "cyan",
    "warning": "yellow",
    "usageWarning": "magenta",
    "critical": "red"
  }
}

​
Options reference

​
colors.context
color
default:"green"
Base color for the context bar fill and the context percentage label. Transitions to warning at 70% and critical at 85%.
​
colors.usage
color
default:"brightBlue"
Base color for the usage bar fill and percentage when usage is below the warning threshold.
​
colors.warning
color
default:"yellow"
Applied to the context bar and related text when context usage is between 70% and 85%.
​
colors.usageWarning
color
default:"brightMagenta"
Applied to the usage bar and percentage when usage approaches the rate limit threshold.
​
colors.critical
color
default:"red"
Applied when context usage exceeds 85%, or when a usage limit has been reached.
Color overrides are preserved when you run /claude-hud:configure. You do not need to re-apply them after using the interactive flow.

Build docs developers (and LLMs) love

Get started for freeTalk to us