ccusage-monitor 1.0.1

Real-time Claude token usage monitor with beautiful terminal interface

🎯 Claude Code Usage Monitor

Real-time terminal monitoring tool for Claude AI token usage. Track consumption, burn rate, and predict when tokens will run out.

✨ Features

• 🔄 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!)

🚀 Quick Start

# Install from PyPI
pip install ccusage-monitor

# Install ccusage CLI tool (required)
npm install -g ccusage

# Run the monitor
ccusage-monitor

Or use without installation:

uvx ccusage-monitor

📖 Basic Usage

# 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

📚 Documentation

• Installation Guide - Detailed installation instructions
• Usage Guide - Complete usage documentation
• Configuration - All configuration options
• Troubleshooting - Common issues and solutions
• Contributing - How to contribute
• Changelog - Version history

🤝 Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

📝 License

MIT License - see LICENSE file.

🙏 Acknowledgments

Built upon ccusage by @ryoppippi.

---

⭐ Star this repo if you find it useful! ⭐

Report Bug • Request Feature