Changelog

All notable changes to claude-telemetry are documented here. This project follows Semantic Versioning.

v0.2.0 (2026-04-06)

Analytics & Rate Limits

• Plan vs API Cost — Compare subscription cost against API-equivalent pricing (Pro/Max5x/Max20x)
• Weekly Reports — Daily/Weekly toggle with stacked bar charts, aligned with rate limit windows
• 5-Hour Blocks — Multi-PC block timeline with active block card, burn rate, and overlap detection
• Rate Limit Progress Bars — Visual 5-hour and weekly rate limit usage in Overview
• Usage Pace Calculator — Daily averages with trend detection (increasing/stable/decreasing)
• Project Budgets — Per-project spending limits with progress bars and alerts
• Cross-Machine Usage Pace — Combined usage metrics across all machines
• Statusline Auto-Setup — One-command rate limit tracking configuration

Improvements

• User preferences synced to Supabase (previously localStorage only)
• Agent uses pythonw.exe on Windows (no console window)
• Dashboard favicon and logo

v0.1.0 (2026-04-04)

Initial Release

Agent

• Python sync agent with JSONL log parsing via ccusage
• Interactive setup command for first-time configuration
• sync command for manual one-time data push
• daemon command for continuous background syncing
• install-service / uninstall-service for OS-native service management
• status command for agent health checks
• Support for Linux (systemd), macOS (launchd), and Windows (Task Scheduler)
• Automatic machine ID generation (UUID)
• Configurable sync interval (default: 15 minutes)
• Offline resilient — retries on next interval if network is unavailable

Dashboard

• React web application deployed to Cloudflare Pages
• 9 dashboard pages:
  • Overview — total cost, daily chart, model pie, machine cards
  • Daily — stacked area chart, top 10 days, hour heatmap
  • Projects — cost by project, pie distribution, full table
  • Models — Opus/Sonnet/Haiku breakdown, mix over time, savings alert
  • Machines — per-machine cards, comparison chart, status badges
  • Deploy — generate agent install commands with one-click copy
  • Sessions — paginated table with sorting and filters
  • Insights — rate projections, optimization tips, trend analysis
  • Settings — machine management, export, alert thresholds
• Dark mode UI
• Machine-level filtering on all pages
• CSV and JSON export
• Responsive design (mobile, tablet, desktop)

Infrastructure

• Cloudflare Worker proxy — zero API keys in frontend
• Supabase Auth with magic link authentication
• Email whitelist for access control
• Row-Level Security on all database tables
• Supabase PostgreSQL with optimized indexes

Data

• ccusage integration for Claude Code JSONL log parsing
• Token tracking: input, output, cache read, cache write
• Cost calculation using Anthropic's published API pricing
• Session metadata: model, timestamps, duration, project path