Claude Code mod

context-usage

Per-session context-window observability. A mod writes each session's context-window figures to a snapshot file and shows the person a toast and a transcript line when the context zone (light, moderate or heavy, from bands in zones.json) worsens; with model_notices on (off by default) it also tells Claude the zone at each crossing, approach and compaction. /context-usage prints status and toggles an optional band row. It answers a status tool. A PostCompact hook leaves a marker.

30 starsContext & usage mods Plugin marketplaceValidates on Claude Code 2.1.323 Source

Install

Inside Claude Code
/plugin marketplace add melodic-software/claude-code-plugins
/plugin install context-usage@melodic-software

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

What it can access

Reach
L0Draws and remembers: draws
Sees
compaction, every prompt, every tool call
Hooks
session.startsession.endsession.compactprompt.submitsession.measureturn.startturn.completecommand.runtool.call

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
melodic-software/claude-code-plugins
Folder
plugins/context-usage
Marketplace
melodic-software
Author
Melodic Software
Type
Context & usage mods
License
MIT
Last updated
13 November 2026
Listed in
awesome-claude-code-mods

FAQ

What is context-usage?

Per-session context-window observability. A mod writes each session's context-window figures to a snapshot file and shows the person a toast and a transcript line when the context zone (light, moderate or heavy, from bands in zones.json) worsens; with model_notices on (off by default) it also tells Claude the zone at each crossing, approach and compaction. /context-usage prints status and toggles an optional band row. It answers a status tool. A PostCompact hook leaves a marker. It is a mod for Claude Code, from melodic-software/claude-code-plugins on GitHub.

What can the context-usage mod access?

Its widest reach is "draws and remembers" (draws). It sees compaction, every prompt, every tool call. Like any mod, it runs with your permissions.

How do I install context-usage?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add melodic-software/claude-code-plugins and then /plugin install context-usage@melodic-software.

Is context-usage popular?

melodic-software/claude-code-plugins has 30 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 13 November 2026.

More context & usage mods

token-meter

280

midudev/better-claude

Each turn's tokens and the session's running total, in color at the end of the hint line under the prompt.

Context & usage mods/plugin install

openrouter-balance

474

hamzafer/claude-code-mods

Your OpenRouter credit above the prompt: the balance with a gauge, today's spend and where the money mostly went. /openrouter-balance shows the breakdown.

Context & usage mods/plugin install

weektoken

3dnow/claude-mods

Rate-limit pace for Claude Code's 5-hour and weekly windows: usage against elapsed time, plain-language forecast, per-model quotas and burn-up history. A band above the prompt and a full /weektoken pane, in English or Chinese.

Context & usage mods/plugin install

⚡

1

Kiyliy/claude-code-tps

Status line showing the model's output speed (tokens/sec), TTFT, total time and session average

Context & usage mods

turn-usage

gmorubio/claude-mods

A dim line under each Claude reply with how much of your current session's usage limit is used and how much that turn spent, or the cost on pay as you go

Context & usage mods/plugin install

account-swap

1

trongtaiz/account-swap

Switch between saved Claude accounts from inside Claude Code, and auto-swap before the active one hits its rate limit.

Context & usage mods/plugin install

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