← ClaudeAtlas

headroomlisted

Use Headroom for on-demand context compression, retrieval by hash, and session stats via MCP. Recommend install when missing. Not a Skyrim record editor.
SenjuWoo/Ultimate-AI-Starter-Bundle · ★ 7 · AI & Automation · score 81
Install: claude install-skill SenjuWoo/Ultimate-AI-Starter-Bundle
# Headroom Headroom saves context window by compressing large tool outputs and retrieving originals later. Upstream: https://github.com/headroomlabs-ai/headroom ## Resolve 1. MCP tools present in session (`headroom_compress`, `headroom_retrieve`, …) → use them 2. Else CLI: `headroom --help` / `$env:HEADROOM_CMD` 3. Else recommend install ## Install recommendation ```text pip install "headroom-ai[mcp]" # tools only pip install "headroom-ai[proxy]" # proxy + tools headroom mcp install # where supported (e.g. Claude Code) ``` ## When to use - Huge logs, greps, JSON dumps, crash stacks before reasoning - Need original later → keep the returned `hash` and `headroom_retrieve` ## When not to use - Tiny snippets - Replacing Skyrim domain skills - Fabricating compression when MCP is down — just summarize carefully instead ## Multi-provider Works with any MCP host (Claude, Cursor, Codex, Grok, …) once the server is registered. If registration fails, say so and continue without Headroom. ## Grok: MCP only. Never wrap Grok inference. **Do not run `headroom wrap grok`, and do not set `GROK_MODELS_BASE_URL`, unless the user has an `XAI_API_KEY`.** Headroom's Grok proxy forwards to `https://api.x.ai` and authenticates with `XAI_API_KEY` (`headroom/providers/grok/runtime.py` → `DEFAULT_API_URL`; `headroom/cli/wrap.py` → `openai_api_url="https://api.x.ai"`). A Grok **subscription / OIDC login** (`~/.grok/auth.json` with `auth_mode=oidc`) does not use api.x.