Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Python agentaianthropicclaude-codecompressioncontext-engineeringcontext-windowcursorfastapilangchainllmmcpopenaiprompt-engineeringproxypythonragtoken-optimizationtokenstypescript
Headroom Simulators
headroom-simulators is a local, deterministic upstream for Headroom proxy tests.
It serves provider-shaped responses without contacting real LLM APIs.
cargo run -p headroom-simulators -- --listen 127.0.0.1:8789
Optional JSON config:
{
"stubs": [
{
"name": "exact chat smoke",
"method": "POST",
"path": "/v1/chat/completions",
"body_contains": "ping",
"response": {
"status": 200,
"headers": {"x-simulator": "configured"},
"json": {"ok": true}
}
}
]
}
Point the proxy at http://127.0.0.1:8789 to run local or CI validations.