iterm-notificationslisted

Manage the macOS notification that fires when a Claude Code tab has been waiting on the user for more than N minutes. Use when the user types /iterm-notifications, asks to enable/disable the "Claude is waiting" notification, wants to change how long it waits before notifying, or wants to test that notifications are working. Accepts on/off, a numeric threshold (minutes), "test" to fire a one-off notification, and "sound <name|none>" to change the alert sound.
wasulajr/headsup · ★ 0 · AI & Automation · score 66

Install: claude install-skill wasulajr/headsup

# iTerm waiting-notifications The launchd watchdog (`claude-code.iterm-watchdog`) runs every 30 seconds. When it finds a tab whose state file has been orange (waiting) for longer than `THRESHOLD_MIN` minutes, it fires a macOS notification. This skill is the user-friendly way to toggle the feature, change the threshold, change the sound, or test that it works. Notifications are posted from the bundled `headsup-notifier.app` at `~/Library/Application Support/headsup/`, so Notification Center renders them with the headsup icon. The bundle is built and installed by `setup.sh` (Step 5/8). No third-party dependencies like terminal-notifier are required. ## Usage forms | Form | Effect | |-----------------------------------|------------------------------------------------------------------------| | `/iterm-notifications` | Show current state (enabled / threshold / sound) | | `/iterm-notifications on` | Enable notifications | | `/iterm-notifications off` | Disable notifications | | `/iterm-notifications <N>` | Set threshold to N minutes (positive integer) | | `/iterm-notifications <N> on` | Set threshold AND enable | | `/iterm-notifications <N> off` | Set thresh