Claude Code Usage Monitor CLI
A real-time terminal monitor for Claude Code usage: tokens, messages and cost in the five-hour window, with forecasts and export
- 8,782 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs a Python process that reads local Claude Code logs in real time
- Optionally keeps usage history in a local store and exports CSV and JSON
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-code-usage-monitorDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a Python process that reads local Claude Code logs in real time
- Optionally keeps usage history in a local store and exports CSV and JSON
This is third-party code. Review the repository files before installing.
What it does
claude-monitor shows a live terminal dashboard of Claude Code token, message and cost usage within the current five-hour window. By default it derives personal limits from recent history, and it also knows the pro, max5, max20 and team plans. Its status line mode captures official rate limit data from Claude Code and labels which numbers are official and which are estimates. It forecasts pace until reset, writes state as JSON for other programs and offers an optional local history store with CSV and JSON reports.
Who it is for. For Claude Code subscribers who often hit limits and want to plan their work.
Good fit when
- You want to see how much is left in the current window
- You want to know if your pace will last until reset
- You need usage history longer than Claude Code keeps
Not a fit when
- You need reports across several agents, not just Claude Code
- You pay per token via API and subscription limits do not matter
Example request
Start the Claude Code usage monitor for the max5 planLimitations
Works only with Claude Code and its local data. Without status line mode limits are estimated from history and may differ from reality. Team plan figures are marked unverified. Requires Python 3.9 or newer.
How to disable. Run uv tool uninstall claude-monitor or pip uninstall claude-monitor. If you enabled status line mode, remove it from Claude Code settings.
FAQ
Which plan should I pick?
The default is custom, which adapts limits to your history. Set a plan explicitly with --plan and it is remembered.
Can I feed the data into my own dashboard?
Yes, --once and --write-state output a machine-readable state snapshot.
Discussion
No questions or reviews yet.
Related
CLI toolsA Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
Token and cost reports for Claude Code, Codex, Gemini CLI and other agents from local logs, by day, month and session
cc-lens
Claude Code Lens (cc-lens)
Local Claude Code analytics: a dashboard of sessions, tokens, cost and projects from your ~/.claude data, no cloud
A statusline for Claude Code: token and cost usage, context left, rate limits and git branch in four styles and six themes
A Claude Code plugin that shows a session's CO2 estimate in the status line next to its cost
Counts token use and cost of Claude Code and Codex sessions from local logs and shows remaining limits in the status line
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Claude Code Usage Monitor (this entry) | no | 8,782 | ||
| Claude Resets: usage reset tracker | no | not required | unofficial tracker of Claude limit resets | |
| TokenTracker | no | 2,149 | tokenTracker counts tokens and spend across Claude Code |
README in short
The README describes the monitor as a local Claude Code usage tool with a live terminal dashboard. The main install is uv tool install claude-monitor, with pip, pipx and source installs as alternatives. It lists CLI options, supported plans, official limits via status line mode, forecasts, export and the history store. A large section covers install and runtime troubleshooting. MIT licensed.