Reference for OS notification configuration. Auto-loads when notifications are enabled (session_init reports notifications active). Also triggered by: 'mute', 'unmute', 'notify', 'notification settings', '/notify', 'notification', 'audio feedback'.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Reference for OS notification configuration. Auto-loads when notifications are enabled (session_init reports notifications active). Also triggered by: 'mute', 'unmute', 'notify', 'notification settings', '/notify', 'notification', 'audio feedback'.
Quick-reference for configuring OS notification feedback on long-running tool completions.
Did I use the correct MCP tool (session vs config) for the desired scope (temporary vs persistent)?
Notification Configuration
Invariant Principles
Session vs Config Scope - Use notify_session_set for temporary overrides (current session only); use notify_config_set for persistent changes across sessions.
Hooks and MCP Are Independent - PostToolUse hooks are controlled by environment variables; notify_session_set/notify_config_set only affect MCP tool behavior.
Interactive Tools Are Excluded - Notifications never fire for interactive or management tools (AskUserQuestion, TodoRead, TodoWrite, Task tools) regardless of duration.
Spellbook provides native OS notifications on long-running tool completions. They auto-trigger via PostToolUse hooks when tools exceed 30 seconds (configurable).
OS Notifications
Uses macOS Notification Center, Linux notify-send, or Windows toast. Threshold: SPELLBOOK_NOTIFY_THRESHOLD. Scope:notify_session_set and notify_config_set only affect MCP tool behavior (notify_send). PostToolUse hooks are separately controlled by SPELLBOOK_NOTIFY_ENABLED env var.
