headroom

A Claude Code mod in vihrea1337/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

headroom reaches L0 (draws and remembers) by its classified calls and passed claude plugin validate on Claude Code 2.1.302.

Events hooked: 12
API methods referenced: 15
Access from classified calls: L0, draws and remembers: persists state, draws
Unclassified calls: 2 ($.state.get, $.state.set), full access unknown
Static scan, not a runtime test

Install hint

/plugin install headroom --marketplace vihrea1337/headroom

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

L1 Reads filesother: $.state.get, other: $.state.set, persists state, draws

Validation

Passed on Claude Code 2.1.302

View the source on GitHub Back to the list

What the scan recorded

Observed events: classic hooks, compaction
Hooks: session.start, session.end, classic.UserPromptSubmit, classic.CwdChanged, turn.step, session.measure, session.compact, session.append, turn.start, turn.complete, command.run {command=headroom}, ui.render {component=AbovePrompt}, ui.render {component=Pane, requestId=headroom}
API calls: $.clock.every, $.clock.now, $.command.register, $.session.usage, $.state.get, $.state.set, $.store.get, $.store.set, $.ui.close, $.ui.notify, $.ui.open, $.ui.resolve, $.ui.scroll, $.ui.status, $.ui.toast
Validation on 2.1.302: Passed
Scanned revision: 67c808ac8197
Marketplace passed: headroom

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. How the scan works.

Badge for your README

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/vihrea1337--headroom--headroom-reach.svg)](https://mods.aidojo.si/mods/vihrea1337--headroom--headroom/)
[![validates](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/vihrea1337--headroom--headroom-validates.svg)](https://mods.aidojo.si/mods/vihrea1337--headroom--headroom/)