Headroom
Capa local que comprime contexto (tools, logs, RAG) antes del LLM. Requiere wrap/proxy; no sustituye usar Cursor o Copilot tal cual.
Entiende el concepto
Qué es
Headroom es una capa de compresión que corre en tu máquina: reduce los tokens de salidas de tools, logs, archivos y chunks RAG antes de que lleguen al modelo. Promete 60–95 % menos tokens en datos estructurados (según sus benchmarks). No es un editor ni un modelo: es infraestructura opcional entre tu agente y el proveedor LLM.
Cómo se activa
No se activa solo por tener Cursor o Claude Code instalados — necesitas uno de estos modos:
| Modo | Qué implica |
|---|---|
headroom wrap <agente> | Lanzas el agente envuelto (Claude Code, Codex, OpenCode, Cline…) |
| Proxy local | headroom proxy --port 8787 y apuntas el cliente a esa URL |
| MCP | Servidor MCP con tools headroom_compress, etc. |
| Librería | Integras compress() en tu propia app |
En Cursor la configuración es manual (proxy + URLs en settings); en Copilot de VS Code, el flujo típico de extensión queda fuera.
¿Nube o local?
El LLM puede seguir siendo de nube — Headroom comprime el contexto antes de enviarlo. Lo local obligatorio es la capa Headroom misma (y modelos auxiliares para algunos compresores). No confundir con Ollama o vLLM: esos sirven modelos; Headroom comprime lo que el agente ya lee.
Nuestra lectura: herramienta de optimización para quien ya domina agentes en terminal y se queda sin contexto por tools ruidosas. Si estás empezando, tu problema no son los tokens — es el contexto del repo: primero AGENTS.md.