Release v3.1.0

🆕 New Features

• 📊 Usage Analysis Views: Added --view parameter for different time aggregation periods
  • --view realtime (default): Live monitoring with real-time updates
  • --view daily: Daily token usage aggregated in comprehensive table format
  • --view monthly: Monthly token usage aggregated for long-term trend analysis

📝 Use Cases

• Daily Analysis: Track daily usage patterns and identify peak consumption periods
• Monthly Planning: Long-term budget analysis and trend identification
• Usage Optimization: Historical data analysis for better resource planning

Release v3.0.4

[HOTFIX] Problem with ubuntu theme

Release v3.0.3

🚨 Breaking Changes

• Package Name Change: Renamed from claude-usage-monitor to claude-monitor
  • New installation: pip install claude-monitor or uv tool install claude-monitor
  • New command aliases: claude-monitor and cmonitor
• Python Requirement: Minimum Python version raised from 3.8 to 3.9
• Architecture Overhaul: Complete rewrite from single-file to modular package structure
• Entry Point Changes: Module execution now via claude_monitor.__main__:main

🏗️ Complete Architectural Restructuring

• 📁 Professional Package Layout: Migrated to src/claude_monitor/ structure with proper namespace isolation
  • Replaced single claude_monitor.py file with comprehensive modular architecture
  • Implemented clean separation of concerns across 8 specialized modules
• 🔧 Modular Design: New package organization:
  • cli/ - Command-line interface and bootstrap logic
  • core/ - Business logic, models, settings, calculations, and pricing
  • data/ - Data management, analysis, and reading utilities
  • monitoring/ - Real-time session monitoring and orchestration
  • ui/ - User interface components, layouts, and display controllers
  • terminal/ - Terminal management and theme handling
  • utils/ - Formatting, notifications, timezone, and model utilities
• ⚡ Enhanced Performance: Optimized data processing with caching, threading, and efficient session management

🎨 Rich Terminal UI System

• 💫 Rich Integration: Complete UI overhaul using Rich library for professional terminal interface
  • Advanced progress bars with semantic color coding (🟢🟡🔴)
  • Responsive layouts with proper terminal width handling (80+ characters required)
  • Enhanced typography and visual hierarchy
• 🌈 Improved Theme System: Enhanced automatic theme detection with better contrast ratios
• 📊 Advanced Display Components: New progress visualization with burn rate indicators and time-based metrics

🔒 Type Safety and Validation

• 🛡️ Pydantic Integration: Complete type safety implementation
  • Comprehensive settings validation with user-friendly error messages
  • Type-safe data models (UsageEntry, SessionBlock, TokenCounts)
  • CLI parameter validation with detailed feedback
• ⚙️ Smart Configuration: Pydantic-based settings with last-used parameter persistence
• 🔍 Enhanced Error Handling: Centralized error management with optional Sentry integration

📈 Advanced Analytics Features

• 🧮 P90 Percentile Calculations: Machine learning-inspired usage prediction and limit detection
• 📊 Smart Plan Detection: Auto-detection of Claude plan limits with custom plan support
• ⏱️ Real-time Monitoring: Enhanced session tracking with threading and callback systems
• 💡 Intelligent Insights: Advanced burn rate calculations and velocity indicators

🔧 Developer Experience Improvements

• 🚀 Modern Build System: Migrated from Hatchling to Setuptools with src layout
• 🧪 Comprehensive Testing: Professional test infrastructure with pytest and coverage reporting
• 📝 Enhanced Documentation: Updated troubleshooting guide with v3.0.0-specific solutions
• 🔄 CI/CD Reactivation: Restored and enhanced GitHub Actions workflows:
  • Multi-Python version testing (3.9-3.12)
  • Automated linting with Ruff
  • Trusted PyPI publishing with OIDC
  • Automated version bumping and changelog management

📦 Dependency and Packaging Updates

• 🆕 Core Dependencies Added:
  • pydantic>=2.0.0 & pydantic-settings>=2.0.0 - Type validation and settings
  • numpy>=1.21.0 - Advanced calculations
  • sentry-sdk>=1.40.0 - Optional error tracking
  • pyyaml>=6.0 - Configuration file support
• ⬆️ Dependency Upgrades:
  • rich: >=13.0.0 → >=13.7.0 - Enhanced UI features
  • pytz: No constraint → >=2023.3 - Improved timezone handling
• 🛠️ Development Tools: Expanded with MyPy, Bandit, testing frameworks, and documentation tools

🎯 Enhanced User Features

• 🎛️ Flexible Configuration: Support for auto-detection, manual overrides, and persistent settings
• 🌍 Improved Timezone Handling: Enhanced timezone detection and validation
• ⚡ Performance Optimizations: Faster startup times and reduced memory usage
• 🔔 Smart Notifications: Enhanced feedback system with contextual messaging

🔧 Installation and Compatibility

• 📋 Installation Method Updates: Full support for uv, pipx, and traditional pip installation
• 🐧 Platform Compatibility: Enhanced support for modern Linux distributions with externally-managed environments
• 🛣️ Migration Path: Automatic handling of legacy configurations and smooth upgrade experience

📚 Technical Implementation Details

• 🏢 Professional Architecture: Implementation of SOLID principles with single responsibility modules
• 🔄 Async-Ready Design: Threading infrastructure for real-time monitoring capabilities
• 💾 Efficient Data Handling: Optimized JSONL parsing with error resilience
• 🔐 Security Enhancements: Secure configuration handling and optional telemetry integration

Release v1.0.18

Update gh actions

Release v1.0.17

Added

• Loading screen that displays immediately on startup to eliminate "black screen" experience
• Visual feedback with header and "Fetching Claude usage data..." message during initial data load

Release v1.0.16

Fixed

• Fixed UnboundLocalError when Ctrl+C is pressed by initializing color variables at the start of main()
• Fixed ccusage command hanging indefinitely by adding 30-second timeout to subprocess calls
• Added ccusage availability check at startup with helpful error messages
• Improved error display when ccusage fails with better debugging information
• Fixed npm 7+ compatibility issue where npx doesn't find globally installed packages

Added

• Timeout handling for all ccusage subprocess calls to prevent hanging
• Pre-flight check for ccusage availability before entering main loop
• More informative error messages suggesting installation steps and login requirements
• Dual command execution: tries direct ccusage command first, then falls back to npx ccusage
• Detection and reporting of which method (direct or npx) is being used

Release v1.0.15

No specific changelog found for version 1.0.15

Release v1.0.14

No specific changelog found for version 1.0.14

v0.0.1 Session Release

What's Changed

• Add Claude Max plan usage tracking and session monitoring by @rvaidya in #2
• Enable session features with new flag by @Maciek-roboblog in #4

New Contributors

• @rvaidya made their first contribution in #2
• @Maciek-roboblog made their first contribution in #4

Full Changelog: v0.0.1...v0.0.1-session

v0.0.1

Full Changelog: https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor/commits/v0.0.1