Claude Code mod

usage-reporter

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

Context & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add cskwork/claude-code-mods
/plugin install usage-reporter@claude-code-mods

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

What it can access

Reach
L3Network: network, reads mod state, draws
Hooks
session.startturn.completecommand.run

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
cskwork/claude-code-mods
Folder
usage-reporter
Marketplace
claude-code-mods
Author
cskwork
Type
Context & usage mods
Last updated
28 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is usage-reporter?

Shows the weekly limit reading and, once configured, POSTs it hourly to your HTTPS endpoint. Off by default. It is a mod for Claude Code, from cskwork/claude-code-mods on GitHub.

What can the usage-reporter mod access?

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

How do I install usage-reporter?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add cskwork/claude-code-mods and then /plugin install usage-reporter@claude-code-mods.

More context & usage mods

usage-report

Schweem/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 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-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-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

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-stats

mina-asham/claude-usage-stats

Shows your Claude plan usage above the prompt: current session (5h) and weekly percentage used, with reset times.

Context & usage mods/plugin install

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