# Headsup Diagnose

> Actively test the Codex headsup stack by flashing idle, working, and waiting tab colors and checking daemon application.

- Skill: `wasulajr/headsup-diagnose-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wasulajr/headsup-diagnose-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wasulajr/headsup-diagnose-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-diagnose-2

---


# Codex Headsup Diagnose

Run the fast color-flash test:

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

Only pass `--restart` if the user explicitly asks for a deep/full test:

```bash
~/.codex/hooks/headsup-codex-diagnose.sh --restart
```

This briefly changes the current iTerm2 tab color, then restores the previous state.