@ngotrnghia1811/opencode-headroom
v0.1.6
Published
Context compression plugin for opencode — port of headroom with Kneedle adaptive-K, BM25 relevance scoring, and CCR reversibility
Maintainers
Readme
@ngotrnghia1811/opencode-headroom
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.
Quick start
npm install @ngotrnghia1811/opencode-headroom// opencode.json
{
"plugin": ["@ngotrnghia1811/opencode-headroom"]
}Documentation
| 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 |
Tools provided
headroom_stats— session compression metrics (tokens saved, compressor hits)headroom_retrieve(hash)— retrieve original content from CCR<<ccr:HASH>>markers
Development
bun install
bun test # 178 tests
bun run typecheck # bundle checkLicense
Apache 2.0
