Context compression plugin for opencode — port of headroom v0.24.0.
Reduces token usage 60–95% on large tool outputs, logs, diffs, and search results — without losing information the LLM needs. Original content is cached locally (CCR) for on-demand retrieval.
npm install @ngotrnghia1811/opencode-headroom// opencode.json
{
"plugin": ["@ngotrnghia1811/opencode-headroom"]
}| Document | Description |
|---|---|
| SETUP.md | Installation, configuration, troubleshooting |
| DEVELOPMENT-PLAN.md | Full porting plan, architecture, implementation phases |
| discrepancy.md | Documented differences from upstream headroom v0.24.0 |
| headroom-learn-todo.md | Design doc for deferred headroom-learn feature |
headroom_stats— session compression metrics (tokens saved, compressor hits)headroom_retrieve(hash)— retrieve original content from CCR<<ccr:HASH>>markers
bun install
bun test # 178 tests
bun run typecheck # bundle checkApache 2.0