What problem does it solve?
Long AI coding sessions accumulate massive context that gets resent every turn, burning through cache and rate limits. headroom compresses that context locally before it reaches the LLM, cutting re-prefill costs and extending productive work time before hitting hard limits.
Core Features & Use Cases
- Per-project toggle: Enable compression only for specific projects via
/headroom on so it never activates without explicit user consent.
- Fail-open proxy: Routes through a local compression proxy on port 8790, but falls back to direct connection if the proxy dies, preventing session-wide outages.
- Cache-preserving compression: Uses deterministic output alignment to keep prefix cache hits intact while shrinking the middle context band.
Quick Start
Use the headroom skill to enable context compression for your current project by running /headroom on and then launch Claude Code through the claude-hr wrapper to start saving tokens on long sessions.