| name | notification |
| description | Fires a native macOS notification (via terminal-notifier) to grab the user's attention when an autonomous flow needs them - a pending clarification, a human gate, the end of a long step, a failure. Takes a title, a message, an optional tone (info/alert), and an optional subtitle. Clicking the notification focuses Kitty. Use when a command, skill, or subagent needs to reach the user outside the chat window. Triggers: "/notification", "notify the user", "alert via macOS". |
| user-invocable | true |
notification
Fire one macOS notification. Always use the bin/notification script — it handles terminal-notifier, Kitty focus, and fallbacks.
notification "<title>" "<message>" [--tone info|alert] [--subtitle "<text>"] [--group <id>]
Options:
--tone alert → Basso sound + default subtitle "Atenção necessária" (use for failures, blockers, unexpected events)--tone info → Glass sound (default, use for progress and gates)--subtitle → line below the title--group → group ID for deduplication/removal (default: claude-code)
To dismiss a notification programmatically after it's been acted on:
notification --remove [--group <id>]
Never let a missing notification block the flow. If bin/notification is not on PATH, fall back to:
osascript -e 'display notification "<message>" with title "<title>" sound name "<sound>"'
And if not on macOS, print 🔔 <title>: <message> to chat and move on.
