# Headsup Colors

> Customize headsup's global iTerm2 tab colors for Codex sessions: idle, working, and waiting. Use when the user asks to change Codex/headsup tab colors.

- Skill: `wasulajr/headsup-colors-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wasulajr/headsup-colors-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wasulajr/headsup-colors-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wasulajr (https://skillmd.com/u/wasulajr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wasulajr/headsup-colors-2

---


# Codex Headsup Colors

Edit `~/.codex/hooks/headsup-status.conf`. Change only these variables:

- `IDLE_COLOR`
- `PROCESS_COLOR`
- `WAIT_COLOR`

Accept 6-character hex values without `#`, or translate common color names yourself. Preserve all other file content.

After editing, if `PROCESS_COLOR` changed, apply it immediately to the current tab because Codex is currently working:

```bash
~/.codex/hooks/headsup-codex-resync.sh
```

If only idle or waiting changed, tell the user the new color will appear on the next matching Codex state.

Do not edit Claude files under `~/.claude`.