Claude Code mod

mod-usage

Shows Claude context, 5-hour and 7-day usage as gradient progress bars above the prompt (Claude Code Desktop / VS Code / mobile). 12 languages.

8 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/jack21/claude-mod-usage.git
claude --plugin-dir ./claude-mod-usage/.

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

What it can access

Reach
L2Writes or runs: runs processes, reads env vars, reads settings, reads mod state, draws
Draws in
AbovePrompt
Hooks
session.startsession.measureui.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

Folder
.
Author
Jack Chiang
License
MIT
Last updated
3 October 2026

FAQ

What is mod-usage?

Shows Claude context, 5-hour and 7-day usage as gradient progress bars above the prompt (Claude Code Desktop / VS Code / mobile). 12 languages. It is a mod for Claude Code, from jack21/claude-mod-usage on GitHub.

What can the mod-usage mod access?

Its widest reach is "writes or runs" (runs processes, reads env vars, reads settings, reads mod state, draws). It draws in AbovePrompt. Like any mod, it runs with your permissions.

How do I install mod-usage?

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

Is mod-usage popular?

jack21/claude-mod-usage has 8 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 3 October 2026.

More context & usage mods

cache-maxxer

8

vayaan-labs/cache-maxxer

Shows the prompt cache's countdown and hit rate above the input box, explains every cache break and cache expiry, and can keep the cache warm to cut Claude Code cost

Context & usage mods

pixel-cat

8

matthlh/claude-mods

A little pixel cat that wanders above the Claude Code prompt, watches your usage limits and announces when work finishes; or switch packs for an adventurer who mines, chops trees and fights zombies

Context & usage mods/plugin install

autotel

8

jagreehal/autotel

OpenTelemetry for Claude Code plugins: adds $.autotel in the engine.create fold so a plugin records spans, traces every hook dispatch with the chain beneath it, and shows each tool call's settled duration on its row. Exports OTLP/HTTP to OTEL_EXPORTER_OTLP_ENDPOINT (autotel-devtools claude sets it).

Context & usage mods

session-meter

8

arasovic/claude-code-mods

Shows a live session pane (/ctx): context breakdown, usage limits with pace, tool calls and model requests; sends the model a one-time note when limits or context cross a threshold, and can let the model compact or clear on its own

Context & usage mods/plugin install

usage-bars

3

pepperonas/usage-bars

Your Claude Code 5-hour and 7-day usage limits as animated bars under the prompt: percent, reset countdown, pace mark, projection, per-answer delta, styles (Pac-Man, beer, tank, battery, hourglass)

Context & usage mods/plugin install

token-tycoon

8

matthlh/claude-mods

A Claude-themed idle game above the prompt: prompt a task block to clear it, hire agents, upgrade models and infra, and earn from your real Claude Code usage

Context & usage mods/plugin install

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