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.

fix: protect Cursor's read_file in the core, not only in the plugin

Tejas Choprae23e73943bb6
diff --git a/headroom/config.py b/headroom/config.py
index 330e20ae4..146db921c 100644
--- a/headroom/config.py
+++ b/headroom/config.py
@@ -231,6 +231,15 @@ DEFAULT_EXCLUDE_TOOLS: frozenset[str] = frozenset(
# Copilot CLI's file-read tool (its `Read` equivalent): raw file bytes
# the model byte-patches against.
"view",
+ # Cursor's file-read tool, the same category as `Read` and `view`. Its
+ # absence here was not a decision: without it Cursor's raw source took
+ # the LOSSY path, which is strictly worse than the fold that
+ # DEFAULT_BYTE_EXACT_EXCLUDE_TOOLS protects it from. Protecting a read
+ # tool needs both halves -- excluded here so it is never lossily
+ # compressed, and named below so it is never folded either -- and a
+ # plugin that supplies only the first half cannot be relied on to be
+ # installed.
+ "read_file",
# Lowercase variants for case-insensitive matching
"read",
"glob",