🎯 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.

📑 Table of Contents

• ✨ Key Features
• 🚀 Installation
  • ⚡ Modern Installation with uv (Recommended)
  • 📦 Installation with pip
  • 🛠️ Other Package Managers
• 📖 Usage
  • Get Help
  • Basic Usage
  • Configuration Options
  • Available Plans
• 🙏 Please Help Test This Release!
• ✨ Features & How It Works
  • Current Features
  • Understanding Claude Sessions
  • Token Limits by Plan
  • Smart Detection Features
• 🚀 Usage Examples
  • Common Scenarios
  • Best Practices
• 🔧 Development Installation
• Troubleshooting
  • Installation Issues
  • Runtime Issues
• 📞 Contact
• 📚 Additional Documentation
• 📝 License
• 🤝 Contributors
• 🙏 Acknowledgments

✨ Key Features

🚀 v3.0.0 Major Update - Complete Architecture Rewrite

• 🔮 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 predic...