Notifications

Notifications

v2.11.3 — Push-notification sinks for the fires-watcher daemon + bin/ops-telegram-bot-send for one-way operator alerts.

The fires-watcher daemon polls your fire sources (ECS health, Sentry) every 60 seconds and pushes a notification the moment a new CRITICAL or HIGH incident appears. You configure one or more sinks — the daemon fans out to all that are configured.

Full sink reference: docs/notifications.md.

Telegram bot push (ops-telegram-bot-send) — v2.11.3

bin/ops-telegram-bot-send pushes to your own Telegram chat using a Bot API token. This is the recommended Telegram sink for fire alerts — lower setup cost than the full user-account MCP path.

	User-account MCP	Bot token (ops-telegram-bot-send)
Auth	phone + 2 login codes + optional 2FA	one token from @BotFather
Reads your DMs	yes	no
Pushes to you	yes	yes
Best for	/ops-inbox telegram triage	fire alerts, rotation results

Setup

1. Message @BotFather → /newbot → copy the token.
2. /start the bot from your own Telegram account.
3. Message @userinfobot to get your numeric chat id.
4. Set env vars or preferences.json:

export TELEGRAM_BOT_TOKEN="<token-from-botfather>"
export TELEGRAM_OWNER_ID="<your-numeric-chat-id>"

5. Test:

ops-telegram-bot-send "test push works"

The fires-watcher picks up TELEGRAM_BOT_TOKEN + TELEGRAM_OWNER_ID automatically — no further configuration needed.

Full doc (including the block-outbound-comms.py self-channel exception): docs/telegram-bot-send.md.

Sink comparison

Priority	Sink	Configure via	Notes
1	Telegram bot	TELEGRAM_BOT_TOKEN + TELEGRAM_OWNER_ID	Recommended. See above.
2	Discord webhook	DISCORD_WEBHOOK_URL	Team channels.
3	ntfy.sh	NTFY_TOPIC	Free, no account.
4	Pushover	PUSHOVER_USER + PUSHOVER_TOKEN	~$5 one-time, most reliable mobile delivery.
5	macOS notification	(Darwin only)	Desktop fallback.
6	stderr log	always	Written to logs/ops-notify.log.

Configure multiple — if your laptop is offline, Pushover still reaches your phone.

Enabling fires-watcher

The watcher is disabled by default. Enable it:

/ops:setup notifications    # guided wizard — sink selection + daemon enable

or manually flip services.fires-watcher.enabled = true in ~/.claude/plugins/data/ops-ops-marketplace/daemon-services.json and restart the daemon.

Testing

scripts/ops-notify.sh CRITICAL "test" "is this thing on"

See also

• Multi-Account Rotator — rotation results are pushed via these same sinks.
• Daemon Guide — fires-watcher runs inside the ops daemon.
• Setup Wizard — step 3n (notification sinks), step 3a (Telegram user-account).