headroom-opencode-standalone

Headroom context compression for OpenCode — spawns the proxy, intercepts provider traffic, exposes reversible compression.

Compresses everything your AI agent reads — tool outputs, logs, files, conversation history — before it reaches the LLM. Same answers, a fraction of the tokens. Runs locally; your data stays on your machine.

Install

# 1. Headroom CLI (one-time)
uv tool install "headroom-ai[all]"
# or: pip install "headroom-ai[all]"

# 2. The plugin
npm install @shutovks/headroom-opencode-standalone

OpenCode config (opencode.jsonc):

{
  "plugins": {
    "@shutovks/headroom-opencode-standalone": {}
  }
}

The plugin starts the local headroom proxy automatically and stops it when OpenCode exits. If no headroom binary is on PATH, it loads as a no-op — your session runs normally, just without compression.

Environment

| Variable | Default | Description | |---|---|---| | HEADROOM_PROXY_PORT | 0 | 0 = free port per instance; set to force a shared proxy port | | HEADROOM_BIN | ~/.local/bin/headroom | Path to the headroom CLI | | HEADROOM_NO_HTTP2 | unset | 1 disables http/2 (fixes TLS corruption under heavy concurrent streams) | | HEADROOM_ANTHROPIC_URL | unset | Anthropic upstream URL (Anthropic handler ignores per-request routing until headroom PR #1502 lands) | | HEADROOM_PROXY_URL | unset | Reuse an externally-managed proxy instead of spawning one |

License

MIT