headsup

Q: How to install headsup?

Create the skills directory: mkdir -p .claude/skills. Then run: mkdir -p .claude/skills && curl -o .claude/skills/headsup.md https://raw.githubusercontent.com/wasulajr/headsup/main/SKILL.md. Finally, /headsup in Claude Code.

Q: What is headsup best for?

headsup is categorized under General.

New

GitHubGeneralby wasulajr

Glanceable Claude Code state in iTerm2 tabs — white=idle, blue=processing, orange=waiting. iTerm2 daemon + launchd watchdog + macOS notifications + six companion skills. macOS only.

First seen 5/26/2026

Install & Usage

Create the skills directory

mkdir -p .claude/skills

Download the skill file

mkdir -p .claude/skills && curl -o .claude/skills/headsup.md https://raw.githubusercontent.com/wasulajr/headsup/main/SKILL.md

Invoke in Claude Code

/headsup

View source on GitHub

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is headsup?

Glanceable Claude Code state in iTerm2 tabs — white=idle, blue=processing, orange=waiting. iTerm2 daemon + launchd watchdog + macOS notifications + six companion skills. macOS only.

How to install headsup?

To install headsup: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/headsup.md https://raw.githubusercontent.com/wasulajr/headsup/main/SKILL.md. Finally, /headsup in Claude Code.

What is headsup best for?

headsup is a skill categorized under General. Created by wasulajr.