configure-notifications

Ported from oh-my-codex configure-notifications. OMX runtime conventions ($macro invocation, omx CLI, .omx/ state directory) are replaced with WorkBuddy idioms (Skill tool, Agent tool, task list, .workbuddy/memory).

Configure Notifications

Unified entry point for notification setup in WorkBuddy.

• Native platforms (first-class): Discord, Telegram, Slack (via webhooks / bot tokens).
• Generic extensibility: custom_webhook_command (POST to a URL) and custom_cli_command (run a local command).

WorkBuddy has no built-in session-end hook system, so this skill writes a config file (.workbuddy/notifications.json at the repo root, or ~/.workbuddy/notifications.json for global). You can wire that file into your own external automation, scheduler, or shell wrapper to actually send the notifications. The skill only manages the configuration.

Step 1: Inspect Current State

CONFIG_FILE=".workbuddy/notifications.json"
if [ -f "$CONFIG_FILE" ]; then
  cat "$CONFIG_FILE"
else
  echo "NO_CONFIG_FILE"
fi

Step 2: Main Menu

Use AskUserQuestion:

Question: "What would you like to configure?"

Options:

1. Discord (native) — webhook URL or bot token + channel.
2. Telegram (native) — bot token + chat id.
3. Slack (native) — incoming webhook URL.
4. Generic webhook command — custom_webhook_command.
5. Generic CLI command — custom_cli_command.
6. Cross-cutting settings — verbosity, idle cooldown, reply listener.
7. Disable all notifications — set notifications.enabled = false.

Step 3: Configure Native Platforms (Discord / Telegram / Slack)

Collect and validate platform-specific values, then write them under native keys:

• Discord webhook: notifications.discord
• Telegram: notifications.telegram
• Slack: notifications.slack

Example config shape:

{
  "notifications": {
    "enabled": true,
    "verbosity": "session",
    "idleCooldownSeconds": 60,
    "discord": { "enabled": true, "webhookUrl": "https://discord.com/api/webhooks/..." },
    "telegram": { "enabled": false, "botToken": "", "chatId": "" },
    "slack": { "enabled": false, "webhookUrl": "" },
    "custom_webhook_command": { "enabled": false, "url": "", "method": "POST", "events": ["session-end"] },
    "custom_cli_command": { "enabled": false, "command": "", "events": ["session-end"] }
  }
}