Claude Code Usage Monitor is a Python tool that tracks Claude Code usage in real time, provides a statusline, machine-readable snapshots, provenance labels, and an opt-in local warehouse for usage data.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Real-time Claude Code usage monitor with predictions and warnings. The repository describes a privacy-first Claude Usage-Ops companion for Claude Code, combining a Rich live terminal monitor with a statusline for official rate_limits, machine-readable outputs, provenance labels, forecasting, and an opt-in local usage warehouse.
How it works
The tool captures Claude Code usage data via a statusline integration and a versioned snapshot protocol. It can export data in multiple formats (state file, json, etc.), supports provenance labeling (official/local_estimate/experimental/unknown), and includes forecasting and pace features. It can scan multiple Claude data directories and write to a local warehouse when enabled.
Getting started
Installation methods include modern uv installation and pip:
# Modern uv install
uv tool install claude-monitor
# Run
claude-monitor # or cmonitor, ccmonitor for short
# Install from PyPI
pip install claude-monitor
# Run from anywhere
claude-monitor # or cmonitor, ccmonitor for short
Usage examples show commands to run help and basic options:
# Show help information
claude-monitor --help
Recent releases
- v4.0.0 (2026-06-27): Bug fixes including Model distribution rendering all model families in ModelUsageBar.
- v3.1.0 (2025-07-23): Added Usage Analysis Views with --view realtime/daily/monthly/etc.
- v3.0.4 (2025-07-14): HOTFIX for Ubuntu theme.
- v3.0.3 (2025-07-14): Breaking Change: Package renamed to claude-monitor; new installation command examples.
- v3.0.2 (2025-07-14): No specific changelog.
Traction
Stars: 8588; Forks: 449; Open issues: 35.
Configuration and usage details (selected)
- Command-line options include --plan, --view, --output, --once, --write-state, --statusline, --warehouse, --timezone, --refresh-rate, --debug, --version, --clear.
- Available plans include custom (default), pro, max5, max20, with token limits and cost estimates.
- Saving preferences between sessions is supported under ~/.claude-monitor/last_used.json, with CLI arguments overriding saved settings.
- Examples show enabling the warehouse, exporting state or views, and using the statusline hook.
License
MIT