SuperCompress

Cut ~65% of LLM input tokens for coding agents — without losing the answer.

Compress bulky context (files, logs, tool dumps, pastes) against the current question. Your ask stays intact.

Website · Benchmarks · Playground · Docs

Install

npm install -g supercompress-proxy

Requires Node.js 18+.

Quick start (recommended)

One command links your account and auto-adds MCP + hooks for every coding agent it detects (Cursor, Claude Code, Codex, Grok Build, OpenCode, fx, Gemini, and more):

supercompress setup

Then restart your agent so integrations reload. That’s it.

Re-detect later (new agent installed, etc.):

supercompress plugin
supercompress agents

Any other agent (custom harness, closed-source, DIY):

supercompress agents connect

That prints a stdio MCP snippet and writes an Agent Plugins 1.0 pack you can drop into any compatible client.

Benchmarks

Same keep-budget (35% of tokens kept). Who still has the answer?

| Method | Answer-critical kept | |---|---:| | FIFO / truncation | 24.8% | | Summarization | 60.5% | | H2O | 97.9% | | SuperCompress | 100% |

| Metric | Result | |---|---:| | Oracle recall (fixed budget) | 100% | | Mean token cut (real suite) | ~67% | | Important lines kept (compiler) | 100% |

Full methodology and charts: supercompress.dev/benchmarks

How it works

Your agent ──→ SuperCompress (hooks / MCP) ──→ smaller context ──→ model
                      ↑
                 query stays whole; only context is compressed

1. You ask a question (never rewritten).
2. Large context is scored against that question.
3. Evidence-critical lines stay in original wording; filler drops.
4. You pay for fewer input tokens.

Commands

| Command | What it does | |---------|----------------| | supercompress / tui | Interactive paper-branded UI (default in a TTY; Bun) | | supercompress setup | Recommended — link account, detect agents, install MCP + hooks | | supercompress plugin | Refresh agent integrations anytime | | supercompress agents | List supported / detected agents | | supercompress start / stop / status | Optional local proxy (setup --proxy) | | supercompress usage | Plan, quota, savings (--json ok) | | supercompress uninstall | Remove configs under ~/.supercompress |

Optional localhost API proxy (base-URL rewrite) if you explicitly need it:

supercompress setup --proxy
supercompress start

Then point OpenAI/Anthropic-compatible clients at http://localhost:8080/v1.

MCP

setup / plugin registers the MCP server on every detected host. You can also run it directly:

supercompress-mcp

Manual registration:

{
  "mcpServers": {
    "supercompress": {
      "command": "supercompress-mcp"
    }
  }
}

| Tool | Purpose | |------|---------| | compress_context | Compress bulky context for a query | | connect_account | Link this install to your dashboard | | usage_summary | Savings for the connected account |

Account & pricing

Free tier + paid credits from the dashboard.
Public PAYG: $0.30 / 1M tokens (see site for current plans).

Privacy

Hooks / MCP run on your machine. Provider API keys stay with your agent. Context text is sent to the SuperCompress API so the hosted compiler can compress it.

More

• Coding agents: https://docs.supercompress.dev/coding-agents
• HTTP / Python API: https://docs.supercompress.dev/quickstart
• Source: https://github.com/Supercompress/Supercompress

License

MIT — see LICENSE.