🚀 Track, analyze, and optimize your Claude usage — locally and in real-time.
• Real-time usage tracking (tokens, models, sessions)
• Cost estimation based on API pricing
• Local-first (no data leaves your machine)
• CLI + Web Dashboard
• Budget protection (alerts + circuit breaker)
• Zero dependencies — runs with Python only
git clone https://github.com/DEADSERPENT/claude-usage
cd claude-usage
# Scan usage logs
python cli.py scan
# Launch dashboard
python cli.py dashboard• Avoid unexpected API costs • Understand token usage patterns • Optimize prompts and model usage • Get visibility beyond Claude’s UI
python cli.py scan # Load usage data
python cli.py today # Today's stats
python cli.py stats # All-time stats
python cli.py dashboard # Open web UI
python cli.py api # Start REST API• Developers using Claude Code • Teams managing LLM costs • AI builders & experimenters
PRs, issues, and ideas are welcome!
MIT License