Skip to content

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.

docs: clarify Cursor setup support (#1439)

JD Davis31f71b880f51
diff --git a/README.md b/README.md
index 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.mdx
index 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
# Aider
headroom 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 Code
ANTHROPIC_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