claudemods

All Claude Code modsmelodic-software/claude-code-plugins

context-usage

A Claude Code mod in melodic-software/claude-code-plugins

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.

context-usage reaches L2 (writes or runs) and passed claude plugin validate with warnings.

Install hint

/plugin install context-usage --marketplace melodic-software/claude-code-plugins

From the repository's own marketplace. Confirm the plugin name in the repository's README before installing. Mods need Claude Code 2.1.287 or later.

Access

L2 Writes or runsruns processes, drives Claude, writes the prompt box, reads files, reads env vars, reads the prompt box, draws

Validation

Passed with warnings

Listed under Context and usage meters for Claude Code.

View the source on GitHub Back to the list

What the scan recorded

Observed events
compaction, every prompt, every tool call
Hooks
session.start, session.end, session.compact, prompt.submit, session.measure, turn.start, turn.complete, command.run {command=context-usage}, ui.render {component=AbovePrompt}, tool.call
API calls
$.clock.every, $.clock.now, $.command.register, $.env.get, $.fs.exists, $.fs.list, $.fs.read, $.fs.stat, $.process.run, $.prompt.read, $.prompt.suggest, $.session.id, $.session.root, $.session.surfaces, $.session.turns, $.session.usage, $.session.version, $.tool.list, $.tool.register, $.ui.invalidate, $.ui.log, $.ui.resolve, $.ui.toast
Validation
Passed with warnings
Scanned revision
3e60834a063d
Marketplace passed
melodic-software

These are the hooks and API calls reported by claude plugin validate. Access levels describe the widest reach of those calls and are not safety ratings. Validation is a static check, not a runtime test, and a passing result does not prove that a mod works or is safe. What a mod can access and how the scan works.

More from melodic-software/claude-code-plugins

Badge for your README

Reach badge for context-usage Validation badge for context-usage

Authors can show the latest scan result in their README. Each badge links to this page.

[![reach](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/melodic-software--claude-code-plugins--context-usage-reach.svg)](https://mods.aidojo.si/mods/melodic-software--claude-code-plugins--context-usage/)
[![validates](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/melodic-software--claude-code-plugins--context-usage-validates.svg)](https://mods.aidojo.si/mods/melodic-software--claude-code-plugins--context-usage/)