Coding agent plugin · v0.5.23

One install. Every agent. Fewer tokens.

Run supercompress setup once. It connects your account, detects coding agents, and auto-installs MCP + hooks so large dumps get compressed before they burn tokens — Cursor, Claude Code, Codex, Zed, FreeBuff, OpenCode, Windsurf, Continue, Gemini, and more. Keep your normal login.

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

npm install alone does not rewrite agent configs. setup links your account and auto-adds MCP + hooks on every detected host. Re-run anytime with supercompress plugin. In a terminal, supercompress (no args) opens the paper-branded TUI (needs Bun).

~64%fewer tokens
1k+npm downloads / week
49agents catalogued
~60mscompress latency

In this guide

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

First 5 minutes checklist

Get SuperCompress running with your coding agents in 4 quick copy-paste steps:

1
Install & link account

Install the CLI globally and run one-time setup to connect your account and auto-configure detected agents:

npm install -g supercompress-proxy
supercompress setup
2
Verify agent detection

Confirm which coding agents on your machine were detected and hooked:

supercompress agents
3
Test MCP connectivity

Verify that the SuperCompress MCP server is responsive locally:

supercompress mcp-check
4
Restart agent & compress

Restart Cursor, Claude Code, Codex, Roo Code, or Cline so the MCP server initializes. Your agent will now automatically call compress_context on bulky context dumps!

How it works

Two layers, installed together by setup:

  1. Hooks (Cursor / Claude Code / Codex) — every user message + large tool dumps auto-compress.
  2. MCP on every detected agent — compress_context for big dumps (subscription / login safe).
# After `supercompress setup` (subscription / login safe)
Coding agent ──→ hooks / compress_context ──→ SuperCompress 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.23

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

Zed

Writes context_servers.supercompress into Zed settings.

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 →