Claude Code Usage Monitor

A beautiful real-time terminal monitoring tool for Claude AI token usage with advanced analytics, machine learning-based predictions, and Rich UI. Track your token consumption, burn rate, cost analysis, and get intelligent predictions about session limits.

Key features:

• ML-based predictions - P90 percentile calculations and intelligent session limit detection
• Real-time monitoring - Configurable refresh rates (0.1-20 Hz) with intelligent display updates
• Advanced Rich UI - Beautiful color-coded progress bars, tables, and layouts with WCAG-compliant contrast
• Smart auto-detection - Automatic plan switching with custom limit discovery
• Enhanced plan support - Updated limits: Pro (44k), Max5 (88k), Max20 (220k), Custom (P90-based)
• Advanced warning system - Multi-level alerts with cost and time predictions
• Professional Architecture - Modular design with Single Responsibility Principle (SRP) compliance
• Intelligent theming - Scientific color schemes with automatic terminal background detection
• Advanced scheduling - Auto-detected system timezone and time format preferences
• Cost analytics - Model-specific pricing with cache token calculations
• Pydantic validation - Type-safe configuration with automatic validation
• Comprehensive logging - Optional file logging with configurable levels
• Extensive testing - 100+ test cases with full coverage
• Error reporting - Optional Sentry integration for production monitoring
• Performance optimized - Advanced caching and efficient data processing