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