Claude Code mod

usage-reporter

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

Context & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/tksunw/usage-reporter.git
claude --plugin-dir ./usage-reporter/.

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

What it can access

Reach
L3Network: network, writes files, reads files, reads env vars, requests an Anthropic credential handle, persists state
Hooks
session.startsession.measureturn.complete

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
tksunw/usage-reporter
Folder
.
Author
Tim Kennedy
Type
Context & usage mods
License
MIT
Last updated
31 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is usage-reporter?

Writes your Claude usage limits and credits to ~/.claude/usage-reporter/usage.json so other tools can read them It is a mod for Claude Code, from tksunw/usage-reporter on GitHub.

What can the usage-reporter mod access?

Its widest reach is "network" (network, writes files, reads files, reads env vars, requests an Anthropic credential handle, persists state). Like any mod, it runs with your permissions.

How do I install usage-reporter?

Clone tksunw/usage-reporter and start Claude Code with --plugin-dir pointing at the mod's folder (.).

More context & usage mods

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

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

aliahmadcse/claude-usage-status

Status line with the model, context fill, session tokens and cost, and the 5-hour and weekly usage limits.

Context & usage mods/plugin install

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