headroom-hud

by Alan R. Soares · ★ 0 · updated 4 days ago

PanesBandsGuardsCommandsPromptTools & agentsvalidates

0

Band above the prompt: context-window gauge, session cost and headroom proxy savings.

install headroom-hud

Install

/plugin marketplace add alanrsoares/claude-mods
/plugin install headroom-hud@alan-mods

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
command.runtool.callprompt.submitsession.startturn.stepturn.startturn.completeui.closeui.render
API calls
$.agent.list$.clock.after$.clock.every$.clock.now$.command.register$.env.get$.http.fetch$.model.complete$.session.compact$.session.messages$.session.model$.session.usage$.state.get$.state.set$.store.delete$.store.get$.store.keys$.store.set$.tool.register$.ui.ask$.ui.close$.ui.invalidate$.ui.open$.ui.panes$.ui.resolve$.ui.toast
Draws
PaneAbovePrompt
Can see
mcp__headroom-hud__compact callsevery prompt
Reach
level 3 of 3 networkdrives Claudereads env varsreads the transcriptreads mod statepersists 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/alanrsoares/claude-mods
Path in repo
headroom-hud
Source commit
f499727 the exact code the scan read
Author
Alan R. Soares @alanrsoares
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.

More from alanrsoares/claude-mods

agent-gate

alanrsoares/claude-mods

Puts every Agent (subagent) call to the permission decider instead of running it unasked.

★ 0Guards

bash-tidy

alanrsoares/claude-mods

Drops redundant cd from Bash commands and asks before cat/grep/sed -i that Read, Grep or Edit would do.

★ 0Guards

laya-router

alanrsoares/claude-mods

Rates each prompt with a local laya-serve, names a model tier, fills it in on Agent calls and can route the main loop.

★ 0Status lineGuardsCommands

ste100

alanrsoares/claude-mods

Asks the model to write in ASD-STE100 Simplified Technical English and lints each answer against its sentence rules.

★ 0Status lineCommandsPrompt

verify-gate

alanrsoares/claude-mods

Asks before git commit or gh pr create while edited code has not passed a check command since its last edit.

★ 0GuardsAutomation