claude

headroom-usage-indicator

Status-line indicator showing whether the headroom MCP context-compression is being used this session — idle until headroom_compress runs, then active with the tokens AND money it saved (priced against the session model), decaying back to idle after a quiet period. Tracks an all-time money-saved total across sessions. Idle badges also nudge with a count of large tool results that went uncompressed, and a broken badge state surfaces silent engine failures (SessionStart micro-doctor included). Includes Dangi, a real-time PostToolUse detector that sizes file-backed blobs at the source and routes advice by size (compress in place vs delegate to a subagent), learns offender files the gate then blocks regardless of extension, and a Stop-hook session ledger that prices what each session saved AND left on the table. The PreToolUse gate rewrites raw `cat` of big structured files into hcat automatically, with a lossless TOON-lite tier that works even without the Python engine.

14 on GitHubby Abhishekv2.8.1MITupdated 1 month ago
/

Plugin headroom-usage-indicator from marketplace headroom-tools in Abhi902/headroom-plugin. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.

What it installs

Skills (2)

  • doctor

    Use when the headroom setup needs a health check or repair — the statusline badge never appears or shows the yellow "headroom broken" badge, hcat is missing from PATH, the headroom MCP tools are unavailable, hooks seem to fire twice, right after installing or updating the headroom-usage-indicator pl

  • headroom-usage-indicator

    Use when you want a persistent visual reminder of whether the headroom MCP compression is actually being used this session — an always-visible status line that stays "idle" until headroom_compress is called, flips to "active" with the tokens AND money it saved (priced against the session's model), t

MCP servers (1)

  • headroom

    runs: headroom mcp serve

Hooks (5)

  • SessionStart

    "${CLAUDE_PLUGIN_ROOT}"/scripts/session-probe.sh

  • PreToolUse

    "${CLAUDE_PLUGIN_ROOT}"/scripts/hcat-gate.sh

  • PostToolUse

    "${CLAUDE_PLUGIN_ROOT}"/scripts/dangi-hook.sh

  • Stop

    "${CLAUDE_PLUGIN_ROOT}"/scripts/ledger-hook.sh

  • SessionEnd

    "${CLAUDE_PLUGIN_ROOT}"/scripts/ledger-hook.sh

View source on GitHub

Similar plugins

claude-mem

claudecodex

Persistent memory for Claude Code: the next session starts where the last one left off.

29 skills · 1 MCP server · hooks

thedotmack/claude-mem 116,618

context7

claudecodex

Up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your coding agent's context.

1 MCP server

upstash/context7 64,709

mempalace

claudecodex

AI memory system — mine projects and conversations into a searchable palace. 47 MCP tools, auto-save hooks, guided setup.

3 skills · 6 commands · 1 MCP server · hooks

MemPalace/mempalace 60,536

chrome-devtools-mcp

claude

Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer

8 skills · 1 MCP server

ChromeDevTools/chrome-devtools-mcp 55,181

gitnexus

claudecodex

Code intelligence powered by a knowledge graph. Provides execution flow tracing, blast radius analysis, and augmented search across your codebase.

12 skills · 1 MCP server · hooks

abhigyanpatwari/GitNexus 48,482

daisyui-blueprint

claude

daisyUI Blueprint MCP server - (Needs paid license)

saadeghi/daisyui 42,821

Maintain headroom-usage-indicator?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex pluginslisted