Claude Code mod

usage-report

Shows context fill, 5-hour and weekly quota, and session cost on the status line under the prompt, with warnings near your limits.

Context & usage mods Plugin marketplace Source

Install

Inside Claude Code
/plugin marketplace add Schweem/usage-report
/plugin install usage-report@usage-report

Mods install like plugins. Run /reload-plugins or start a new session to load it.

What it can access

Reach
L1Reads: reads mod state, draws
Hooks
session.startsession.measure

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
Schweem/usage-report
Folder
.
Marketplace
usage-report
Author
Schweem
Type
Context & usage mods
License
MIT
Last updated
1 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is usage-report?

Shows context fill, 5-hour and weekly quota, and session cost on the status line under the prompt, with warnings near your limits. It is a mod for Claude Code, from Schweem/usage-report on GitHub.

What can the usage-report mod access?

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

How do I install usage-report?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add Schweem/usage-report and then /plugin install usage-report@usage-report.

More context & usage mods

usage-mods

akixi-maison/usage-mods

Shows whether Claude is working, waiting on you or done, and context, rate-limit and cost usage, above the prompt

Context & usage mods/plugin install

usage-reporter

cskwork/claude-code-mods

Shows the weekly limit reading and, once configured, POSTs it hourly to your HTTPS endpoint. Off by default.

Context & usage mods/plugin install

usage-mod

speranzapedro/usage-mod

Mostra quanto você já usou da janela de 5 horas e da semanal, e quando cada uma reinicia, numa faixa acima do chat. 8 personalizações: Padrão, LoL, CS, Carro, The Sims, Pokémon, Pac-Man e Windows 95.

Context & usage mods/plugin install

usage-reporter

tksunw/usage-reporter

Writes your Claude usage limits and credits to ~/.claude/usage-reporter/usage.json so other tools can read them

Context & usage mods

usage-mod

kreddevils18/claude-usage-mod

Your Claude Code usage as colored chips above the prompt: 5h and weekly limits (% left), session cost and spend history. /usage-mod opens the full view.

Context & usage mods/plugin install

usage-rings

dglasgal/usage-rings

Claude plan usage rings with reset times, what your Claude Code and Cowork usage would cost at API prices, a leaderboard of your most expensive sessions, spend alerts, and fire-and-money graphics.

Context & usage mods/plugin install

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