# Headsup Notifications

> Manage macOS notifications for Codex tabs that have been waiting longer than a configured threshold.

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

---


# Codex Headsup Notifications

Pass the user's requested args through to:

```bash
~/.codex/hooks/headsup-codex-notifications.sh "$@"
```

Useful forms:

- `on`
- `off`
- `<N>` for threshold minutes
- `<N> on`
- `<N> off`
- `test`
- `sound <name>`
- `sound none`

The LaunchAgent `codex.headsup-watchdog` runs the waiting sweep every 30 seconds.