Claude Code mod

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

1 starsContext & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add vihrea1337/headroom
/plugin install headroom@headroom

Mods install like plugins. Run /reload-plugins or start a new session to load it.

What it can access

Reach
L1Reads: reads mod state, persists state, draws
Sees
classic hooks, compaction
Draws in
AbovePromptPane
Hooks
session.startsession.endclassic.UserPromptSubmitclassic.CwdChangedturn.stepsession.measuresession.compactsession.appendturn.startturn.completecommand.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.
Claude Code docs

Details

Repository
vihrea1337/headroom
Folder
.
Marketplace
headroom
Author
vihrea1337
Type
Context & usage mods
License
MIT
Last updated
10 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is 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 It is a mod for Claude Code, from vihrea1337/headroom on GitHub.

What can the headroom mod access?

Its widest reach is "reads" (reads mod state, persists state, draws). It sees classic hooks, compaction. It draws in AbovePrompt, Pane. 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 vihrea1337/headroom and then /plugin install headroom@headroom.

Is headroom popular?

vihrea1337/headroom has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 10 October 2026.

More context & usage mods

headroom

1

MWEJ/claude-code-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

Context & usage mods/plugin install

hud

1

BedirYilmaz/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.

Context & usage mods/plugin install

gear

1

moelahmady/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.

Context & usage mods

hud

1

Samarth2001/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

Context & usage mods/plugin install

fishstack

1

patrick-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.

Context & usage mods/plugin install

idle-compact

1

benredmond/idle-compact

Compacts an idle session just before its prompt cache expires, so returning does not re-write the full context

Context & usage mods/plugin install

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.