Claude Code mod
headroom
Your Claude plan limits, a forecast of when you'll run out, and your context window, live in a band above the prompt. Compacts in one click, automatically, or when Claude picks the moment, and keeps the prompt cache warm
Install
/plugin marketplace add MWEJ/claude-code-headroom
/plugin install headroom@claude-code-headroomMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- Unknown
- Sees
- /"^mcp__headroom__compaction$"/ calls, every tool call, compaction, classic hooks
- Draws in
AbovePrompt- Hooks
tool.checktool.callsession.compactsession.startsession.measureui.focusui.pressprompt.editturn.startturn.completesession.endclassic.PostModelSwitchconfig.setcommand.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.
Details
- Repository
- MWEJ/claude-code-headroom
- Folder
.- Marketplace
claude-code-headroom- Author
- Martin Hygge
- License
- MIT
- Last updated
- 7 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is headroom?
Your Claude plan limits, a forecast of when you'll run out, and your context window, live in a band above the prompt. Compacts in one click, automatically, or when Claude picks the moment, and keeps the prompt cache warm It is a mod for Claude Code, from MWEJ/claude-code-headroom on GitHub.
What can the headroom mod access?
Its reach could not be worked out from its code. It sees /"^mcp__headroom__compaction$"/ calls, every tool call, compaction, classic hooks. It draws in AbovePrompt. Like any mod, it runs with your permissions.
How do I install headroom?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add MWEJ/claude-code-headroom and then /plugin install headroom@claude-code-headroom.
Is headroom popular?
MWEJ/claude-code-headroom has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 7 October 2026.
More context & usage mods
gear
1moelahmady/jev-model-router
Routes each turn's reasoning effort with TypeSafe's Jev decision model, keeping the prompt cache (Claude Code 2.1.280+). Model routing is available but off by default and refused above maxSwitchTokens, since a model switch re-writes the whole context.
headroom
1vihrea1337/headroom
Headroom: rate-limit countdowns and a burn-rate forecast for Claude Code. When each window resets, whether it lasts at this pace, alerts at 80/95% and on reset, a session budget, a week of history and a clickable prompt log
fishstack
1patrick-lai/claude-fish-stack-mod
A fishStack pane for Claude Code: a perm worktree with a read-only head start, crew dials and a context library.
hud
1BedirYilmaz/claude-crt-hud-mod
A CRT-style status panel above or below the prompt: model, project and git, context with a compact button, plan usage, prompt cache, cost and running tools. /hud toggles it.
eventlog-context
1radiator-engineering/eventlog
Replaces context compaction in the controller's interactive session of a log-driven repo: the conversation is rebuilt from .context/events.jsonl by `eventlog context`, plus the last few turns word for word. Rebuilds at the log's task boundaries and at a fill backstop; /rebuild queues a rebuild for the end of the next turn, and /compact rebuilds from the log at once. Inert in headless sessions, for other EVENTLOG_AS writers, with EVENTLOG_CONTEXT=off, and in a repo without the log. Falls back to the engine's compaction when eventlog fails.
hud
1Samarth2001/claude-plugins
A live usage cockpit above the prompt: context, plan limits with pace forecasts, and cost by day, week and month, in a one-line glance that expands into tabs and a dashboard pane
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.