virtualian/pai/notification

Customization

Before executing, check for user customizations at: ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/Notification/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

Slash Command Interface

This skill implements /notification with per-channel toggle control:

/notification voice on       # Enable voice notifications
/notification voice off      # Disable voice notifications
/notification desktop on     # Enable desktop notifications
/notification desktop off    # Disable desktop notifications
/notification status         # Show current notification channel states
/notification all off        # Disable all notification channels
/notification all on         # Enable all notification channels

Workflow Routing

When user requests toggling voice notifications: Examples: "/notification voice on", "/notification voice off", "turn off voice", "mute voice", "unmute voice", "disable voice notifications", "enable voice", "silence the curls", "stop voice announcements" -> Action: Read ~/.claude/settings.json, set notifications.voice to true or false, write back. Confirm the change. -> Feedback: "Voice notifications [enabled/disabled]. Verbal announcements [on/off]."

When user requests toggling desktop notifications: Examples: "/notification desktop on", "/notification desktop off", "turn off desktop", "mute desktop", "disable desktop notifications" -> Action: Read ~/.claude/settings.json, set notifications.desktop to true or false, write back. Confirm the change. -> Feedback: "Desktop notifications [enabled/disabled]."

When user requests notification status: Examples: "/notification status", "notification status", "what notifications are on", "show notification settings" -> Action: Read ~/.claude/settings.json and display current state of all notification channels. -> Output format:

Notification Channel Status:
  voice:   [ON/OFF]  — Verbal announcements
  desktop: [ON/OFF]  — Desktop alerts
  ntfy:    [ON/OFF]  — Push notifications (mobile)
  discord: [ON/OFF]  — Discord webhook
  twilio:  [ON/OFF]  — SMS notifications
 
Available commands:
  /notification [channel] on/off
  /notification all on/off

When user requests toggling all notifications: Examples: "/notification all off", "/notification all on", "mute all", "unmute all", "silence everything", "turn on all notifications" -> Action: Read ~/.claude/settings.json, set notifications.voice and notifications.desktop to the requested state, write back. Confirm the change. -> Feedback: "All notification channels [enabled/disabled]."

Settings Location

Notification state is stored in ~/.claude/settings.json under the notifications key:

{
  "notifications": {
    "voice": { "enabled": true },
    "desktop": { "enabled": true },
    "ntfy": { "enabled": true, ... },
    "discord": { "enabled": true, ... },
    ...
  }
}

• voice.enabled (boolean): Controls verbal announcements. When false, Notify.ts exits silently without contacting the voice server.
• desktop.enabled (boolean): Controls desktop notification delivery.

Both boolean format ("voice": true) and object format ("voice": { "enabled": true }) are supported for backwards compatibility.

Settings persist across sessions automatically since they live in settings.json.

Implementation Details

Voice Suppression Mechanism

The voice toggle works through Notify.ts (self-gating CLI tool):

1. Algorithm emits bun ~/.claude/skills/PAI/Tools/Notify.ts "message"
2. Notify.ts reads notifications.voice from settings.json
3. If false -> exits silently (no network call made)
4. If true (or missing) -> checks session context
5. If main session -> POSTs to voice server
6. If subagent -> exits silently (subagent announcements always suppressed)

Gating happens at the source — Notify.ts decides whether to call the voice server, no external hook needed.

Desktop Suppression

Desktop notifications are sent via macOS osascript or notification hooks. When notifications.desktop is false, notification-sending code should check this setting before firing.

When to Activate This Skill

Direct Notification Commands

• "/notification voice on/off"
• "/notification desktop on/off"
• "/notification status"
• "/notification all on/off"

Natural Language Triggers

• "turn off voice notifications"
• "mute the voice", "silence curls"
• "stop announcing phases"
• "enable voice", "unmute"
• "what notification channels are on"
• "show notification settings"
• "disable all notifications"

Related Documentation

• Notification System: ~/.claude/skills/PAI/THENOTIFICATIONSYSTEM.md
• Notify.ts: ~/.claude/skills/PAI/Tools/Notify.ts
• Settings: ~/.claude/settings.json → notifications section