Claude Usage — a plugin that puts your Claude Code plan limits and 30-day token/cost history in a CloudCLI tab

[HandyS11]

Hi everyone 👋

I built Claude Usage, a plugin that adds a dedicated tab to CloudCLI showing exactly where you stand with Claude Code — no more switching to the terminal to run /usage or wondering why you suddenly hit a limit mid-session.

What it shows

🔴 Live plan limits — the same data that powers Claude Code's /usage screen:

• Session (5h window), weekly, and per-model utilization gauges
• Severity coloring and reset countdowns
• Auto-refreshes every 60 seconds

📊 30-day history — parsed locally from your ~/.claude/projects/**/*.jsonl transcripts:

• Daily token bar chart
• Totals: tokens, estimated cost, session count
• Per-model and per-project breakdowns, so you can see which project is actually eating your budget

How it works

A small backend subprocess exposes two endpoints through the host's RPC proxy:

• /live reads the OAuth token from ~/.claude/.credentials.json and calls Anthropic's usage endpoint (cached 30s). It never writes to your credentials and never touches the refresh token — if the token is expired, it just asks you to run claude once.
• /history aggregates your local transcripts (deduped, mtime-cached) into daily/model/project stats. Costs come from a bundled price table.

Both sections fail independently: no credentials still gives you history, and vice-versa. Everything runs locally — nothing is sent anywhere except the one call to Anthropic's own API.

Install

Open Settings > Plugins, paste the repo URL, and click Install:

👉 https://github.com/HandyS11/cloudcli-plugin-claude-usage

Small caveat: the live-usage endpoint is unofficial, so it may change — the plugin degrades gracefully if it does.

Feedback, bug reports, and PRs are very welcome. I'd especially love to hear if the cost estimates match what you expect, and what breakdowns you'd like to see next. 🙏

[blackmammoth]

hey there! this is awesome. You can also share it in https://discord.gg/buxwujPNRE in Showcase channel