Claude Code mod
usage-gauge
(superseded by rd-ledger) A live cost chip in the prompt footer and a /spend Usage pane: the session's cost, context by category, rate limits, tokens and cache hit per model, subagent share and code changes, without /usage landing in the transcript.
Install
/plugin marketplace add Joseph-Ayoub/claude-mods
/plugin install usage-gauge@joseph-modsMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L1Reads: reads mod state, draws
- Sees
- Edit|Write|NotebookEdit calls
- Draws in
PromptHintSessionModePane- Hooks
session.startsession.measureturn.stepturn.completetool.callcommand.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.
Details
- Repository
- Joseph-Ayoub/claude-mods
- Folder
usage-gauge- Marketplace
joseph-mods- Author
- Joseph Ayoub
- License
- MIT
- Last updated
- 12 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is usage-gauge?
(superseded by rd-ledger) A live cost chip in the prompt footer and a /spend Usage pane: the session's cost, context by category, rate limits, tokens and cache hit per model, subagent share and code changes, without /usage landing in the transcript. It is a mod for Claude Code, from Joseph-Ayoub/claude-mods on GitHub.
What can the usage-gauge mod access?
Its widest reach is "reads" (reads mod state, draws). It sees Edit|Write|NotebookEdit calls. It draws in PromptHint, SessionMode, Pane. Like any mod, it runs with your permissions.
How do I install usage-gauge?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add Joseph-Ayoub/claude-mods and then /plugin install usage-gauge@joseph-mods.
More context & usage mods
usage-forecast
thangdo19/claude-code-mods
A live forecast of your context window, plus your session and weekly usage limits, in the band above the prompt.
usage-gauges
maximemarc/Claude-mods
Bande projet, branche, diff et agents, jauges contexte, 5 h et hebdo, coût de session et alertes de seuil
usage-footer
Guidin9/claude-usage-footer
Shows how much of your Claude 5-hour (and weekly) usage limit is left, always visible at the bottom-right of the Claude Code prompt footer — no more typing /usage.
usage-guard
aliaksei-loi/usage-guard
Winds sessions and subagents down before the 5-hour or 7-day subscription limit: one wind-down note per band, a handoff file, spawn and loop denies near the limit, optional resume after the reset
usage-footer
BuzzScud/my-Claude-mods
One row in the footer: the context and your usage limits (5-hour, week, a model's own week) as bar tiles that fill as they are used, coloured by how full they are, each with its reset time, all four kept down to a 120-column window. /limits on | off.
usage-guard
Marnel8/claude-mods-
Asks before a large or token-heavy prompt is sent, showing your 5-hour and weekly usage and an estimate of what it may cost
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.