Repolode
hystax

hystax/optscale-kompressor

削除した内容を必要に応じて取得できる、コーディングエージェントのプロンプトやツール出力を決定論的に圧縮するRustバイナリ。

スター
21
フォーク
6
未解決の Issue
13
最終コミット
18 時間前

これは何?

OptScale Kompressorは、Codex、Claude Code、Aiderなどのコーディングエージェントが各ステップでモデルに再送する作業履歴のサイズを削減します。主な対象は、長いビルドログ、コンパイラ出力、一覧表示です。決定論性を重視しており、同じ入力からは毎回同じバイト列が生成されるため、プロバイダーのプロンプトキャッシュが引き続きヒットします。削除された各フラグメントはコンテンツアドレス方式のハンドルに紐付けて保存され、モデルはretrieveツールを通じて再取得できます。

CLI、HTTP API、MCPサーバーとして使えるほか、OpenAI Chat Completions、OpenAI Responses、Anthropic Messages向けのLLMプロキシとしても動作する単一のバイナリで提供されます。`kompressor wrap codex`コマンドを実行すると、プロキシを起動してエージェントの接続先を設定し、終了時に後片付けを行います。圧縮はモデルをダウンロードせずローカルで実行され、順序付きのコンテンツ検出とソースコード向けのtree-sitter文法を利用します。モードはaggressive(非可逆)、lossless、recoverable(デフォルト)の3種類です。

リポジトリの報告によると、Terminal-Bench 2.1の89タスクで、圧縮なしの場合と比較してコストを22.7%削減しました。この測定値は、プロンプトキャッシュの割引を含むプロバイダーの請求額に基づいています。

主な機能

  • 01出力が決定論的なため、ターンをまたいでプロンプトキャッシュのヒットを維持できます。
  • 02削除した内容はハンドルと組み込みのretrieveツールを使って取得できます。
  • 03Codex、Claude、Aider、OpenCode、Cursorをラップできるほか、あらゆるクライアント向けのプロキシとしても動作します。
  • 04モデルをダウンロードせずローカルで動作し、ルールベースの検出とコード向けのtree-sitterを利用します。
  • 05同じバイナリからCLI、HTTP API、MCPサーバー、Rustライブラリを提供します。

ユースケース

  • ビルドやテストの出力が大量にある、長時間のコーディングエージェントのセッションでトークンコストを削減する。
  • ツールの結果を圧縮する共有ローカルプロキシに、チームのLLMトラフィックを経由させる。
  • MCPサーバーに対応したエージェントに、MCPベースの圧縮と取得機能を追加する。

クイックスタート

  1. 1

    Cargoでインストール(Rust 1.90以降)

    cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli
  2. 2

    compressor proxy経由でCodexを実行

    kompressor wrap codex

使う前に知っておきたいこと

  • 自動ラップはCodexのみ対応しています。Claude Codeは圧縮されず、そのまま通過します。
  • プロキシがプロトコルを読み取れないため、Cursor-agentは拒否されます。
  • ベンチマーク結果は、プロジェクトのベンダーであるOptScale AIによる自己申告です。

トピック

よくある質問

optscale-kompressor とは?
削除した内容を必要に応じて取得できる、コーディングエージェントのプロンプトやツール出力を決定論的に圧縮するRustバイナリ。 OptScale Kompressorは、Codex、Claude Code、Aiderなどのコーディングエージェントが各ステップでモデルに再送する作業履歴のサイズを削減します。主な対象は、長いビルドログ、コンパイラ出力、一覧表示です。決定論性を重視しており、同じ入力からは毎回同じバイト列が生成されるため、プロバイダーのプロンプトキャッシュが引き続きヒットします。削除された各フラグメントはコンテンツアドレス方式のハンドルに紐付けて保存され、モデルはretrieveツールを通じて再取得できます。
optscale-kompressor は無料で使えますか?ライセンスは?
optscale-kompressor は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
optscale-kompressor は今もメンテナンスされていますか?
活発にメンテナンス中。optscale-kompressor の最終コミットは 2026年10月20日 です。
optscale-kompressor は何に使えますか?
ビルドやテストの出力が大量にある、長時間のコーディングエージェントのセッションでトークンコストを削減する。 ツールの結果を圧縮する共有ローカルプロキシに、チームのLLMトラフィックを経由させる。 MCPサーバーに対応したエージェントに、MCPベースの圧縮と取得機能を追加する。
optscale-kompressor のインストール方法は?
Cargoでインストール(Rust 1.90以降): cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli compressor proxy経由でCodexを実行: kompressor wrap codex
optscale-kompressor はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/hystax/optscale-kompressor

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト