Usage Meter — AI skill for Claude Code

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.

git clone https://github.com/rohit3a/usage-meter.git
cd usage-meter
deploy/install.sh

Then open a new Claude Code session (or run `/reload-plugins` in an open one) and type `/burn`.

`install.sh` is idempotent. It links `mod/` into `~/.claude/skills/usage-meter` so every session loads it, and installs the collector as a systemd user service (Linux) or launchd agent (macOS). The first run reads your existing transcripts, so history shows up right away.

More than one machine

Name each machine and point it at the others by SSH host (anything `ssh ` reaches, e.g. a Tailscale name). Key-based SSH is required; sync runs in the background.

deploy/install.sh --host Desktop --peer Laptop=my-laptop   # on the desktop
deploy/install.sh --host Laptop                             # on the laptop

How it works

• collector/umeter.py: one per machine, always running (systemd user service on Linux, launchd agent