Claude Code mod

usage-stats

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

Context & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add mina-asham/claude-usage-stats
/plugin install usage-stats@claude-usage-stats

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

What it can access

Reach
L3Network: network, writes files, reads files, reads env vars, reads mod state, requests an Anthropic credential handle, persists state, draws
Draws in
AbovePrompt
Hooks
session.startsession.measurecommand.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
mina-asham/claude-usage-stats
Folder
.
Marketplace
claude-usage-stats
Author
Mina Asham
Type
Context & usage mods
Last updated
10 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is usage-stats?

Shows your Claude plan usage above the prompt: current session (5h) and weekly percentage used, with reset times. It is a mod for Claude Code, from mina-asham/claude-usage-stats on GitHub.

What can the usage-stats mod access?

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

How do I install usage-stats?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add mina-asham/claude-usage-stats and then /plugin install usage-stats@claude-usage-stats.

More context & usage mods

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

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

Jump-High-Kid/claude-mods

One line above the prompt: 5h/weekly usage with reset times, context %, repo, model and effort

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

hicrandn/claude-mods

Your Claude usage limit, as a one-line torch bar above the prompt that fades as you use it.

Context & usage mods/plugin install

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