# Headsup

> Show the default headsup health/status snapshot for Claude Code tabs. Use when the user types /headsup, asks whether headsup is working, or wants the quick overview rather than a specific focused command. For focused actions, route to /headsup-label, /headsup-config, /headsup-status, /headsup-diagnose, /headsup-colors, /headsup-notifications, or /headsup-update.

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

---


# /headsup

Default headsup overview for Claude Code.

## What to do

Run the read-only status report:

```bash
~/.claude/hooks/headsup-status-report.sh
```

Let the report stand on its own unless the user asks a follow-up.

## Related focused commands

- `/headsup-label`: set the current tab title/badge/watermark
- `/headsup-config`: settings hub for labels, colors, notifications, and new-tab launch modes
- `/headsup-status`: explicit passive health snapshot
- `/headsup-diagnose`: active color/status test
- `/headsup-colors`: change idle/working/waiting colors
- `/headsup-notifications`: waiting-tab notifications
- `/headsup-update`: update headsup from source