headroom

by Martin Hygge · ★ 0 · updated 6 days ago

BandsStatus lineGuardsCommandsPromptTools & agentsvalidates

0

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 headroom

Install

/plugin marketplace add MWEJ/claude-code-headroom
/plugin install headroom@claude-code-headroom

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

What it hooks into

From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.

Events
tool.checktool.callsession.compactsession.startsession.measureui.focusui.pressprompt.editturn.startturn.completesession.endclassic.PostModelSwitchconfig.setcommand.runui.render
API calls
$.agent.list$.clock.after$.clock.every$.clock.now$.command.register$.command.run$.config.list$.env.get$.env.set$.fs.read$.fs.stat$.http.fetch$.model.fork$.process.run$.session.append$.session.authorize$.session.compact$.session.id$.session.usage$.state.get$.state.set$.store.get$.store.set$.tool.register$.ui.log$.ui.resolve$.ui.status$.ui.toast
Draws
AbovePrompt
Can see
/"^mcp__headroom__compaction$"/ callsevery tool callcompactionclassic hooks
Reach
level 3 of 3 other: $.state.getother: $.state.setnetworkruns processessets env varsdrives Claudereads filesreads env varsreads the transcriptpersists statedraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/MWEJ/claude-code-headroom
Path in repo
repository root
Source commit
055c9af the exact code the scan read
Author
Martin Hygge @MWEJ
License
MIT
First published
Last pushed
First listed here

Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.