mirror of
https://github.com/tiennm99/claude-status-webhook.git
synced 2026-04-17 13:21:01 +00:00
tiennm99
8c993df72b
- Statuspage webhook always returns 200 to prevent subscriber removal - Fix parseKvKey returning string chatId instead of number - Queue consumer retries on Telegram 5xx instead of acking (prevents message loss) - Fix observability top-level enabled flag (false → true) - Add defensive null checks for webhook payload body - Cache Bot instance per isolate to avoid middleware rebuild per request - Add vitest + @cloudflare/vitest-pool-workers with 31 tests - Document DLQ and KV sharding as declined features
claude-status-webhook
Telegram bot that forwards Claude Status updates to subscribed users. Instant notifications when Claude goes down — incidents, component changes, and resolutions.
Fully serverless on Cloudflare Workers (free tier). Zero infrastructure to manage.
Features
- Real-time incident alerts — new incidents, updates, and resolutions with impact severity
- Component status changes — e.g., API goes from Operational → Degraded Performance
- Subscription preferences — incidents only, components only, or both
- Component filtering — subscribe to specific components (e.g., API only)
- Supergroup topic support — notifications routed to the topic where
/startwas sent - Live status check —
/statusfetches current data from status.claude.com - Self-healing — automatically removes subscribers who block the bot
Bot Commands
| Command | Description |
|---|---|
/help |
Detailed command guide with examples |
/start |
Subscribe to notifications |
/stop |
Unsubscribe from notifications |
/status [name] |
Current system status (optionally for a specific component) |
/subscribe <type> |
Set preferences: incident, component, or all |
/subscribe component <name> |
Filter to a specific component |
/history [count] |
Recent incidents (default 5, max 10) |
/uptime |
Component health overview |
Quick Start
git clone https://github.com/tiennm99/claude-status-webhook.git
cd claude-status-webhook
npm install
See Setup Guide for full deployment instructions.
Documentation
| Doc | Description |
|---|---|
| Setup Guide | Prerequisites, deployment, Telegram & Statuspage configuration |
| System Architecture | Entry points, data flow, KV schema, queue processing |
| Feature Decisions | Evaluated features and rationale for decisions |