Skip to content

v1.2.0 - Headroom Context Compression MCP

Choose a tag to compare

@JZKK720 JZKK720 released this 19 Jul 17:50

🧊 CubeCloud Skills Bundle v1.2.0 — Headroom Context Compression

This release adds headroom-ai as the 12th CLI tool and 7th MCP server. Headroom is a context compression layer for AI agents — it compresses tool outputs, logs, RAG chunks, files, and conversation history before they reach the LLM. 60-95% fewer tokens for JSON, 15-20% for coding agents. Same answers, fraction of the tokens.

What's new

  • headroom-ai (CLI + MCP server) — installed via uv tool install "headroom-ai[proxy]". The MCP server exposes three tools to Copilot Chat: headroom_compress (shrink large outputs), headroom_retrieve (fetch original on demand), headroom_stats (compression metrics).

Resolved: Windows Defender false positive

headroom-ai depends on ast-grep-cli, whose Rust-compiled sg.exe binary triggers a Windows Defender false positive ("virus or potentially unwanted software", os error 225). This release ships a scoped Defender exclusion script (bin/add-defender-exclusion-ast-grep.ps1) that excludes only the ast-grep install path and sg.exe process — not Defender globally. The setup script now adds this exclusion automatically before attempting the headroom install (requires admin; if non-admin, it warns and points the user to the manual script).

Updated counts

v1.1.0 v1.2.0
Skills 64 64
CLIs 11 12 (+ headroom)
MCP servers 6 7 (+ headroom)
Fork mirrors 23 23

Install

git clone https://github.com/JZKK720/cubecloud-skillsboundle-setup.git ~/dev/setup
powershell -NoProfile -ExecutionPolicy Bypass -File ~/dev/setup/setup-global-skills.ps1

If headroom fails to install on a fresh machine, run this in an elevated PowerShell first:

powershell -NoProfile -ExecutionPolicy Bypass -File ~/dev/bin/add-defender-exclusion-ast-grep.ps1

Then re-run the setup script.

Full inventory

See the README for the complete skill list, CLI table, and MCP server details.