Claude Code mod

UsageBreakdown

Shows what uses up your Claude limits: tokens by model, by main chat versus agents, and by project, across every chat on this Mac

2 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/Heuwzen/claude-runway.git
claude --plugin-dir ./claude-runway/usage-breakdown

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L1Reads: reads files, reads mod state, persists state, draws
Draws in
Pane
Hooks
session.startturn.stepsession.endcommand.runui.render

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Repository
Heuwzen/claude-runway
Folder
usage-breakdown
Author
Heuwzen
Type
Context & usage mods
License
MIT
Last updated
21 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is UsageBreakdown?

Shows what uses up your Claude limits: tokens by model, by main chat versus agents, and by project, across every chat on this Mac It is a mod for Claude Code, from Heuwzen/claude-runway on GitHub.

What can the UsageBreakdown mod access?

Its widest reach is "reads" (reads files, reads mod state, persists state, draws). It draws in Pane. Like any mod, it runs with your permissions.

How do I install UsageBreakdown?

Clone Heuwzen/claude-runway and start Claude Code with --plugin-dir pointing at the mod's folder (usage-breakdown).

Is UsageBreakdown popular?

Heuwzen/claude-runway has 2 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 21 October 2026.

More context & usage mods

usage-panel

2

andrewbakercloudscale/claude-code-cost-sidebar

The usage panel in a sidebar inside Claude Code: this session, today, the last 30 days, projects, top sessions, the day's costliest turns with why each was dear, what pauses cost in cache written again, and insights, with graphs, and, where Claude Burst is installed, the context it really sends by part and Plan Utilisation: how much of the plan's 5-hour and weekly limits is used and which projects used it, with a warning as one gets close. /usage-panel opens it, /usage-panel pin and /usage-panel unpin choose whether every session opens it

Context & usage mods/plugin install

usageline

2

Sma1lboy/claude-mods

A status line under the prompt: context, cache hit rate, cache TTL countdown, today's spend for this project, and why a turn missed the cache. /usage prints the project ledger.

Context & usage mods/plugin install

usage-meter-mod

2

wendyyyanto/usage-meter-mod

A band above the message input that shows, at a glance, how close you are to your usage limits and how full the context is. It is a mod for Claude Code and the Claude desktop app's Code tab.

Context & usage mods/plugin install

usagemeter

2

Elesiann/usagemeter

A /usagemeter pane with cost, tokens and plan limits across Claude Code, Codex, OpenCode and Antigravity, read from local history and a CLIProxyAPI hub.

Context & usage mods/plugin install

usage-meter

2

akerskuuug/claude-mods

Directory, branch, worktree, model, effort and prompt-cache warmth, with 5h and weekly limits (subscription) or cost (pay-per-token), above the prompt; context below it

Context & usage mods/plugin install

vigil

2

revenantworks/claude-skills

Revenantworks dashboard mod for Claude Code 2.1.287+: which skills are enabled and how each fires (slash or automatic), failures, likely misroutes, tokens and cost by skill; the 5-hour, weekly, context and cache meters on the status line; health (mods loaded, hook drift, gatewarden's event counts); background tasks; optional research, GPU-lease, Godot and PR panels; and a suggestion queue that proposes, never builds. /rw-vigil opens it; Claude reads it only through vigil_read. Counts only, never text; counts stay in this session until /rw-vigil records on.

Context & usage mods/plugin install

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.