supercompress-proxy

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, 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

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

• You ask a question (never rewritten).
• Large context is scored against that question.
• Evidence-critical lines stay in original wording; filler drops.
• 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.