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
docs: clarify Cursor setup support (#1439)
JD Davis31f71b880f51
diff --git a/README.md b/README.mdindex 104c587d9..6187b6cfd 100644--- a/README.md+++ b/README.md@@ -48,7 +48,7 @@ Headroom compresses everything your AI agent reads — tool outputs, logs, RAG c- **Library** — `compress(messages)` in Python or TypeScript, inline in any app- **Proxy** — `headroom proxy --port 8787`, zero code changes, any language-- **Agent wrap** — `headroom wrap claude|codex|cursor|aider|copilot|opencode` in one command+- **Agent wrap** — `headroom wrap claude|codex|aider|copilot|opencode` in one command; Cursor prints manual proxy settings to paste into the app- **MCP server** — `headroom_compress`, `headroom_retrieve`, `headroom_stats` for any MCP client- **Cross-agent memory** — shared store across Claude, Codex, Gemini, auto-dedup- **`headroom learn`** — mines failed sessions, writes corrections to `CLAUDE.md` / `AGENTS.md`@@ -194,7 +194,7 @@ shows an **Output Tokens Saved** card next to input compression, labelled|--------------|:---------------:|----------------------------------|| Claude Code | ✅ | `--memory` · `--code-graph` · `--1m` || Codex | ✅ | shares memory with Claude |-| Cursor | ✅ | prints config — paste once |+| Cursor | Manual setup | starts proxy and prints base URLs for Cursor settings || Aider | ✅ | starts proxy + launches || Copilot CLI | ✅ | starts proxy + launches || OpenClaw | ✅ | installs as ContextEngine plugin |diff --git a/docs/content/docs/proxy.mdx b/docs/content/docs/proxy.mdxindex ebcec1c23..707d3666a 100644--- a/docs/content/docs/proxy.mdx+++ b/docs/content/docs/proxy.mdx@@ -203,7 +203,7 @@ Set `x-headroom-bypass: true` to skip compression.## Agent wrapping-Use `headroom wrap` to transparently proxy any CLI tool:+Use `headroom wrap` to launch supported CLI agents through the local proxy:```bash# Claude Code@@ -215,18 +215,22 @@ headroom wrap codex# Aiderheadroom wrap aider-# Cursor+# Cursor (starts the proxy and prints settings to paste into Cursor)headroom wrap cursor```-Or set the base URL manually:+Cursor reads model endpoints from its settings UI, so `headroom wrap cursor`+does not rewrite Cursor configuration or launch the app. After it starts the+proxy, copy the printed base URL into Cursor's model settings.++For environment-driven clients, you can also set the base URL manually:```bash# Claude CodeANTHROPIC_BASE_URL=http://localhost:8787 claude-# Cursor / any OpenAI-compatible client-OPENAI_BASE_URL=http://localhost:8787/v1 cursor+# Any OpenAI-compatible CLI client that reads OPENAI_BASE_URL+OPENAI_BASE_URL=http://localhost:8787/v1 your-client```## Cloud providers