Real-time terminal monitoring tool for Claude AI token usage. Track consumption, burn rate, and predict when tokens will run out.
- 🔄 Real-time monitoring - Updates every 3 seconds
- 📊 Visual progress bars - Token and time usage at a glance
- 🔮 Smart predictions - Know when tokens will deplete
- 🤖 Auto-detection - Automatically detects your token limits
- 📋 Multiple plans - Supports Pro, Max5, Max20
⚠️ Smart warnings - Alerts before token depletion- 🎨 Rich UI mode - Beautiful, flicker-free terminal interface (NEW!)
# Install from PyPI
pip install ccusage-monitor
# Install ccusage CLI tool (required)
npm install -g ccusage
# Run the monitor
ccusage-monitorOr use without installation:
uvx ccusage-monitor# Default (Pro plan)
ccusage-monitor
# Specify plan
ccusage-monitor --plan max5
ccusage-monitor --plan max20
ccusage-monitor --plan custom_max # Auto-detect
# Custom timezone
ccusage-monitor --timezone US/Eastern
# Custom reset hour
ccusage-monitor --reset-hour 9
# Beautiful Rich UI mode (recommended!)
ccusage-monitor --rich- Installation Guide - Detailed installation instructions
- Usage Guide - Complete usage documentation
- Configuration - All configuration options
- Rich UI Guide - Beautiful terminal interface guide
- Project Architecture - Complete system architecture overview
- Project Flowchart - Visual system flow and process diagrams
- Developer Guide - Development setup and contribution guide
- API Reference - Complete API documentation
- Troubleshooting - Common issues and solutions
- Contributing - How to contribute to the project
- Changelog - Version history and updates
Contributions are welcome! See CONTRIBUTING.md for guidelines.
MIT License - see LICENSE file.
Built upon ccusage by @ryoppippi.
⭐ Star this repo if you find it useful! ⭐