mirror of
https://github.com/tiennm99/claude-status-webhook.git
synced 2026-04-17 11:20:30 +00:00
tiennm99
7949da3734
- Replace string-interpolated console.log/error with JSON.stringify for searchable/filterable CF Workers dashboard logs - Add shared JSDoc typedefs (Subscriber, QueueMessage, ChatTarget) with @param/@returns annotations on key functions - Guard against undefined WEBHOOK_SECRET env var (auth bypass on misconfigured deploy) - Add 3 declined features to feature-decisions.md (fan-out decoupling, idempotency keys, /ping)
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 |