SuperCompress

SuperCompress

SuperCompress v2 — 回答を損なわずに、コーディングエージェントへのLLM入力トークンを約64％削減します。

約4億個のパラメーターを持つNeural Keepが、SuperCompress API上で、大量のコンテキスト（ファイル、ログ、ツールの出力、貼り付けたテキスト）を現在の質問に照らして評価し、不要な部分を取り除きます。質問はそのまま維持されます。このパッケージは、MCPとフックを介して、Cursor／Claude Code／Codex／40以上のハーネスをこのAPIに接続します。

ウェブサイト · ベンチマーク · プレイグラウンド · ドキュメント

---

インストール

npm install -g supercompress-proxy

Node.js 18以降が必要です。

---

クイックスタート（推奨）

1つのコマンドでアカウントを連携し、40以上のハーネスにMCP + フックを自動追加します（25以上のハーネスでは、Cursor、Claude Code、Codex、Goose、Zed、OpenCode、fx、Hermes、OpenClaw、Grok Build、Grok Bot（ホスト型MCP URL）、Gemini、Windsurf、Continueなどにネイティブの自動MCPプラグインを追加します）。

supercompress setup
supercompress doctor

その後、連携を再読み込みするためにエージェントを再起動してください。これで完了です。

後から再検出する場合（新しいエージェントをインストールした場合など）：

supercompress plugin
supercompress agents
supercompress doctor

その他のエージェント（カスタムハーネス、クローズドソース、DIY）：

supercompress agents connect

stdio MCPスニペットを出力し、互換性のある任意のクライアントに追加できるAgent Plugins 1.0パックを書き込みます。

ベンチマーク

同じ保持予算（トークンの35％を保持）。それでも回答を維持できるのはどれでしょうか？

方法	回答に不可欠な内容の保持率
FIFO／切り詰め	24.8%
要約	60.5%
H2O	97.9%
SuperCompress	100%

指標	結果
オラクル再現率（固定予算）	100%
平均トークン削減率（実データセット）	約67%
重要な行の保持率（コンパイラー）	100%

方法論とグラフの全文：supercompress.dev/benchmarks

---

仕組み

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

1. 質問します（書き換えられることはありません）。
2. 大量のコンテキストを、その質問に照らして評価します。
3. 根拠として重要な行は元の表現のまま残し、不要な部分は取り除きます。
4. 入力トークンが減るため、コストを抑えられます。

---

コマンド

コマンド	機能
supercompress / tui	論文をイメージしたインタラクティブUI（TTYではデフォルト、Bun）
supercompress setup	推奨 — アカウントを連携し、エージェントを検出してMCP + フックをインストール
supercompress plugin	エージェント連携をいつでも更新
supercompress doctor	ハーネスごとの状態一覧（アカウント／MCP／フック）
supercompress agents	40以上のカタログ — 自動プラグインとレシピ／接続方式
supercompress start / stop / status	オプションのローカルプロキシ（setup --proxy）
supercompress usage	プラン、クォータ、節約額（--jsonも利用可能）
supercompress limits	プロバイダーのレート制限までの余裕 — 5時間／週間の期間（エージェント向けの--json）
supercompress uninstall	~/.supercompress以下の設定を削除

明示的に必要な場合は、オプションのローカルホストAPIプロキシ（ベースURL書き換え）を利用できます。

supercompress setup --proxy
supercompress start

その後、OpenAI／Anthropic互換クライアントの接続先をhttp://localhost:8080/v1に設定してください。

---

MCP

setup / pluginを実行すると、検出されたすべてのホストにMCPサーバーが登録されます。直接実行することもできます。

supercompress-mcp

手動で登録する場合：

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

ツール	目的
compress_context	クエリに合わせて大量のコンテキストを圧縮
connect_account	このインストールをダッシュボードに連携
usage_summary	連携済みアカウントの節約額
runway_check	プロバイダーのレート制限までの余裕（ローカルで実行。アカウント不要）

Runway（レート制限）

supercompress limits --json / MCP runway_check は、プロバイダーのクォータがどれだけ残っているか、残りのクォータをどう使うべきかをエージェントに伝えます。limitcheck をベースに、SuperCompress が接続するすべてのハーネスに対応するよう拡張されています。Runway はこのパッケージ内でローカルに実行されます。使用状況のデータがホスト型 API を経由することはなく、ホスト型 MCP に runway ツールはありません。各チェック（limits のステータスまたは runway_check。ステータスラインは対象外）では、公開されている合計値 limitcheck.supercompress.dev に匿名のカウントが 1 件送信されます。送信されるのは判定結果（go / land / pace / wait / unknown）と cli または mcp のみです。ID、使用量の数値、プロンプト、パスは送信されません。SUPERCOMPRESS_TELEMETRY=0、DO_NOT_TRACK=1、または SUPERCOMPRESS_RUNWAY=0 で無効にできます。setup / plugin は自動的にインストールします。すべてのエージェントの指示とスキルに runway ルールを追加し、ローカル MCP に runway_check を登録し、スタンドアロンのランタイムを ~/.supercompress/runway/ にコピーし、Claude Code のステータスラインに接続します。uninstall を実行すると、これらすべてが元に戻ります。

ソース	ハーネス
~/.codex/sessions のレート制限イベント（設定不要）	Codex
setup（または supercompress limits connect claude-code）で接続されるステータスラインのティー。既存のステータスラインは変更せず、そのまま動作します	Claude Code
ローカルプロキシが受信した上流のレート制限ヘッダー（Anthropic、OpenAI、xAI、OpenRouter、Codex）	localhost:8080 経由でルーティングされるあらゆるハーネス（Aider、Continue、Cline、OpenCode、Goose、…）
supercompress limits ingest --provider <id>（標準入力の JSON）/ SUPERCOMPRESS_LIMITS_SNAPSHOT / LIMITCHECK_SNAPSHOT	その他すべて（Cursor、Windsurf、Grok Build、Gemini CLI、カスタムフック）

アクション：go（scope を伴う）、land（作業を続け、各ステップの前にチェックポイントを作成）、pace（バランス型ポリシーのみ）、wait（実際に使い切った場合。waitMinutes、alternatives を提示）、unknown（情報源なし。決して推測しません）。

デフォルトの max ポリシーでは、固定の 10% の下限で停止せず、5h ウィンドウをプロバイダーの期限まで使い切ります。短いウィンドウは自動的にリセットされるため、未使用のクォータは無駄になります。週単位／月単位のウィンドウは、ペース（残りの割合と残り時間）で判断されます。--policy conservative では、limitcheck の 25% / 10% のしきい値が維持されます。シード済みシミュレーション（node test/runway-sim.js）では、max は制約となる 5h ウィンドウの 100% を使用します（91.5% に対して）。これにより、完了したステップが +7.8% となり、60 回の期限のうち 59 回前にチェックポイントが作成されます。SUPERCOMPRESS_RUNWAY=0 にすると、setup によるステータスラインの変更を防ぎ、プロキシのヘッダー取得を無効にします。保存されるのはレート制限の数値のみ（~/.supercompress/limits/）で、プロンプトや応答は保存されません。

---

アカウントと料金

ローンチ記念プロモーション：月 5M トークンまで無料。その後は ダッシュボード から 100 万トークンあたり $0.10 です。

---

プライバシー

フック／MCP はお使いのマシン上で実行されます。プロバイダーの API キーはエージェント側に保持されます。ホスト型コンパイラーがコンテキストを圧縮できるよう、コンテキストテキストは SuperCompress API に送信されます。

---

詳細

• コーディングエージェント：https://docs.supercompress.dev/coding-agents
• HTTP / Python API：https://docs.supercompress.dev/quickstart
• ソース：https://github.com/Supercompress/Supercompress

ライセンス

MIT — LICENSE を参照してください。