Headsup Notifications

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

wasulajr Updated

File contents

Codex Headsup Notifications

Pass the user's requested args through to:

~/.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.

wasulajr/headsup/tree/main/codex-skills/headsup-notifications commit ba8d7fa7f7

Frequently asked questions

npx skillmds@latest add wasulajr/headsup-notifications-2