Features Overview
claude-telemetry ships with a full web dashboard, multi-PC sync agent, secure infrastructure, real-time analytics, and deep Claude Code integration. Here's what's available.
Core (v0.1.0)
Web Dashboard
A dark-mode React dashboard with 10 pages covering every angle of your Claude Code usage. Filter by machine, model, project, and time period. Learn more →
Multi-PC Aggregation
Install the sync agent on every machine you use. Data flows to a central Supabase database, giving you a unified view. Learn more →
Auto-Sync Daemon
The Python agent runs as a background service on Linux (systemd), macOS (launchd), and Windows (Task Scheduler). Learn more →
Secure by Default
Cloudflare Worker proxy, magic link auth, email whitelist, Row-Level Security. No API keys in the frontend. Learn more →
Deploy Page
Wazuh-style deployment page generates OS-specific install commands pre-filled with your credentials. Add new machines in minutes.
CSV/JSON Export
Export any dashboard view to CSV or JSON for further analysis or reporting.
Configurable Alerts
Set cost thresholds and get notified when you exceed them.
Analytics & Rate Limits (v0.2.0)
| Feature | Description | Page |
|---|---|---|
| ✅ 5-Hour Blocks | Multi-PC block timeline with overlap detection and burn rate | Details → |
| ✅ Weekly Reports | Daily/Weekly toggle with stacked bar charts, aligned with rate limit windows | Details → |
| ✅ Burn Rate | Usage pace with trend detection | Details → |
| ✅ Cost Comparison | Plan vs API equivalent pricing (Pro/Max5x/Max20x) | Details → |
| ✅ Project Budgets | Per-project spending limits with progress bars and alerts | Details → |
| ✅ Rate Limit Progress | Visual 5-hour and weekly rate limit usage in Overview | — |
| ✅ Usage Pace Calculator | Daily averages with trend detection (increasing/stable/decreasing) | — |
Real-time, Analytics & PyPI (v0.3.0)
| Feature | Description | Page |
|---|---|---|
| ✅ Real-time Hooks | Sub-100ms data sync via SessionEnd + Stop hooks | Details → |
| ✅ MCP Server | 12 tools — ask Claude about your usage in natural language | Details → |
| ✅ Insights Engine | Trends, anomalies, forecasts, week-over-week in the dashboard | Details → |
| ✅ Webhook Alerts | Discord/Slack notifications for budgets and rate limits | Details → |
| ✅ Unified Setup | Interactive cc-telemetry setup wizard with dependency checks | — |
| ✅ cc-telemetry doctor | 10-point health check command | — |
| ✅ PyPI Publishing | pip install cc-telemetry — no more git clone required | — |