Coding agent plugin · v0.5.2

One install. Every agent. Fewer tokens.

Run supercompress setup to connect your account, detect coding agents, and install an MCP plugin that compresses large dumps before they burn tokens — Cursor, Claude Code, Codex, FreeBuff, OpenCode, and more. Keep your normal login. No provider API-key mode required.

Install in 30 seconds 
npm install -g supercompress-proxy
supercompress setup

npm install alone does not rewrite agent configs. setup links your SuperCompress account, detects agents, and installs the MCP plugin. Re-run anytime with supercompress plugin.

~65%fewer tokens
49agents catalogued
MCPsubscription-safe
~60mscompress latency

In this guide

  1. How it works
  2. Install
  3. Detect + plugin
  4. Supported agents
  5. MCP tools
  6. Dashboard
  7. Optional API proxy
  8. Uninstall

How it works

Default path is MCP-first. Your agent keeps its normal Cursor / Claude / Codex / FreeBuff / OpenCode login. When context gets huge — file dumps, search results, logs, diffs — the agent calls compress_context. SuperCompress returns a smaller, evidence-preserving version metered to your plan.

# Default — subscription / login safe
Coding agent ──→ compress_context ──→ SuperCompress API
                 MCP tool              ~65% fewer tokens

# Optional — only if you want localhost base-URL proxy mode
Coding agent ──→ localhost:8080/v1 ──→ provider API
Privacy The MCP server runs on your machine. Context is sent to the SuperCompress compression API so the hosted compiler can process it. Provider API keys never leave your agent — and MCP mode does not require them at all.

Install

npm install -g supercompress-proxy
supercompress --version
# → 0.5.2

Or one-shot without a global install:

npm install supercompress-proxy
npm exec supercompress setup

Detect + plugin

setup links your account and installs the MCP plugin. Prefer plugin anytime you add a new agent:

supercompress setup
supercompress plugin
$ supercompress plugin
✓ Detected Cursor, Claude Code, Codex, FreeBuff, OpenCode, …
✓ MCP plugin installed for: Cursor, FreeBuff, OpenCode, Codex MCP, …
✓ Cursor rule written
→ Works with login — no provider API-key mode
→ Restart your coding agent so MCP reloads
1
Install

Add supercompress-proxy with npm.

2
Link

supercompress setup opens the dashboard and connects your account.

3
Restart

Reload Cursor / Claude / Codex / FreeBuff / OpenCode so MCP servers load.

4
Compress

Ask the agent to compress large context — tool: compress_context.

Supported agents

The detector catalog covers 49 integrations. These get first-class MCP auto-plugin today:

Cursor

Writes ~/.cursor/mcp.json + always-on rule.

MCP

Claude Code

Registers in ~/.claude.json.

MCP

Codex

Updates ~/.codex/config.toml MCP block.

MCP

FreeBuff

Global Codebuff/FreeBuff MCP via ~/.agents/mcp.json.

MCP

OpenCode

Writes mcp.supercompress into opencode.jsonc.

MCP

Gemini CLI

Registers in Gemini settings MCP servers.

MCP

Also detected (manual endpoint / MCP where available)

WindsurfContinueClineAiderGooseOpenHandsRoo CodeCopilot CLIAmazon QPiCrush+ more

Run supercompress agents to see what is installed on your machine.

MCP tools

ToolWhat it does
compress_contextCompress bulky coding context for a query. Returns compressed text + savings.
connect_accountOpen the dashboard to link this install if you skipped setup.
usage_summaryPer-agent token savings for the connected SuperCompress account.

Dashboard tracking

After agents start compressing, your dashboard shows per-agent requests, tokens in/out/saved, and last-used time. Only usage metadata is sent — never prompt contents.

Optional API proxy

If you want the older base-URL rewrite path (provider API-key mode), opt in explicitly:

supercompress setup --proxy
supercompress start

That wires http://localhost:8080/v1 for compatible OpenAI/Anthropic endpoints. Most subscription/login agents should stay on the default MCP plugin path instead.

When to use --proxy Only when your agent already uses a provider API key and exposes a configurable OpenAI/Anthropic base URL. ChatGPT-login Codex and similar hosted backends are not intercepted by the local proxy — use MCP.

Uninstall

supercompress uninstall
npm uninstall -g supercompress-proxy

Uninstall removes MCP registrations, restores backed-up configs, and cleans ~/.supercompress.

Next: Usage →