setup

Notification Center Setup

Default Behavior

Desktop notifications are enabled out of the box. No configuration needed.

Commands

/notify:setup                    # Show status, offer to add channels
/notify:setup telegram           # Add Telegram
/notify:setup slack              # Add Slack
/notify:setup teams              # Add Teams
/notify:setup lark               # Add Lark/Feishu
/notify:setup webhook            # Add custom webhook
/notify:setup off telegram       # Remove Telegram (deletes credentials)
/notify:setup off all            # Remove all channels (needs confirmation)

Flow: No argument

Show current status, then gently offer options:

Desktop notifications are active (default).

You can also receive notifications on other channels:

• telegram — Telegram bot messages
• slack — Slack incoming webhook
• teams — Microsoft Teams webhook
• lark — Lark/Feishu custom bot
• webhook — Custom HTTP endpoint

Want to add any?

Do NOT force the user to pick. Desktop is already working.

Flow: Add channel

Guide the user through configuring that specific channel:

telegram:

1. Ask for bot token (from @BotFather)
2. Ask for chat ID (from @userinfobot)

slack:

1. Ask for incoming webhook URL

teams:

1. Ask for incoming webhook URL (supports both legacy and Power Automate workflows)

lark:

1. Ask for custom bot webhook URL

webhook:

1. Ask for webhook URL

Write configuration

Add the channel to existing NOTIFY_CHANNELS (don't replace) and set credentials in ~/.claude/settings.json under env:

{
  "env": {
    "NOTIFY_CHANNELS": "desktop,telegram",
    "NOTIFY_TELEGRAM_TOKEN": "bot-token-here",
    "NOTIFY_TELEGRAM_CHAT": "chat-id-here"
  }
}

IMPORTANT: Read the existing settings.json first and MERGE — never replace existing env vars.

Test the notification

After configuring a new channel, test it:

echo '{"cwd":"'$PWD'"}' | CLAUDE_HOOK_EVENT=TaskCompleted NOTIFY_CHANNELS=<new-channel> <credentials> ${CLAUDE_PLUGIN_ROOT}/hooks/notify.sh