Claude Code Usage Monitor is a developer-focused terminal tool that provides real-time visibility into Claude Code token consumption and session behavior. The project is designed to help users avoid unexpectedly hitting usage caps by continuously tracking token burn rate, message counts, and estimated costs during active sessions. It presents analytics through a visually rich terminal interface built with modern Python tooling, making it easy to interpret usage trends at a glance. The system includes predictive logic that estimates whether a session is likely to exceed limits before completion, allowing proactive adjustments to workflows. Its architecture emphasizes modularity and extensibility, supporting multiple Claude plan configurations and customizable monitoring behavior. Overall, the tool fills an important observability gap for heavy Claude Code users who need precise, local insight into AI usage economics and session management.
Features
- Real-time monitoring of Claude token and message usage
- Predictive analysis of session limits and burn rate
- Rich terminal UI with color-coded analytics
- Multi-plan support with automatic detection
- Cost estimation and usage trend views
- Configurable refresh rates and monitoring modes