Show HN: Claude Code Usage Monitor – real-time tracker to dodge usage cut-offs

Summary

🎯 Claude Code Usage Monitor A beautiful real-time terminal monitoring tool for Claude AI token usage. Track your token consumption, burn rate, and get predictions about when you'll run out of tokens. 📑 Table of Contents ✨ Features 🔄 Real-time monitoring - Updates every 3 seconds with smooth refresh - Updates every 3 seconds with smooth refresh 📊 Visual progress bars - Beautiful color-coded token and time progress bars - Beautiful color-coded token and time progress bars 🔮 Smart predictions - Calculates when tokens will run out based on current burn rate - Calculates when tokens will run out based on current burn rate 🤖 Auto-detection - Automatically switches to custom max when Pro limit is exceeded - Automatically switches to custom max when Pro limit is exceeded 📋 Multiple plan support - Works with Pro, Max5, Max20, and auto-detect plans - Works with Pro, Max5, Max20, and auto-detect plans ⚠️ Warning system - Alerts when tokens exceed limits or will deplete before session reset - Alerts when tokens exceed limits or will deplete before session reset 💼 Professional UI - Clean, colorful terminal interface with emojis - Clean, colorful terminal interface with emojis ✨ No screen flicker - Smooth updates without clearing the entire screen - Smooth updates without clearing the entire screen ⏰ Customizable reset times - Set your own token reset schedule 🚀 Installation Prerequisites Python 3.6+ installed on your system pytz Python package: pip install pytz ccusage CLI tool installed globally: npm install -g ccusage Quick Setup # Clone the repository git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git cd Claude-Code-Usage-Monitor # Make the script executable chmod +x ccusage_monitor.py # Run the monitor ./ccusage_monitor.py 📖 Usage Basic Usage Run with default settings (Pro plan - 7,000 tokens): ./ccusage_monitor.py 💡 Smart Detection: When tokens exceed the Pro limit, the monitor automatically switches to custom_max mode and displays a notification. Sp...