mirror of
https://github.com/tiennm99/claude-status-webhook.git
synced 2026-10-11 03:13:18 +00:00
tiennm99
83103b3b3b
@cloudflare/vitest-pool-workers was renamed to @cloudflare/vitest-plugin for its v1 release; the old name stopped at 0.22.0 with pinned vulnerable wrangler and miniflare versions. Vitest stays on 4: the plugin's peer range is still ^4.1.0.
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 |