rohit3a/usage-meter
14 stars · Last commit 2026-10-09
Where every Claude token goes, live: plan-limit %, tokens and API-equivalent $ by machine, session, subagent and model. A Claude Code mod.
README preview
# usage-meter **Where every Claude token goes, live.** A Claude Code mod that shows your plan-limit %, tokens and API-equivalent $, split by machine, session, subagent, prompt and model, right inside Claude Code: in the status line, a live band above the prompt, and a `/burn` pane. - **Limit %, learned from your own data.** It fits how fast each model burns *your* plan's 5h and weekly limits, so "budget left" is in real terms rather than guesswork. - **API-equivalent $** for every request at list prices, cache writes by TTL, fast mode, web search. - **Every machine in one view.** Run a collector on each box and they sync over SSH. - **Codex too.** Follows Codex runs, links the ones Claude launched to the chat that started them, and can stop them. - **Never double counts.** Every request is keyed by its API message id. - **Stays fast.** A background collector does the math; the mod only redraws when the summary changes. ## Install Needs Python 3.9+ and Claude Code (terminal or the desktop app's Code tab). Linux or macOS. ```bash git clone https://github.com/rohit3a/usage-meter.git