Mibayy/token-savior

何を解決するか

Token Savior は、AI コーディングエージェント（例：Claude Code）で一般的な巨大なトークン消費とコンテキストウィンドウの肥大化を軽減することを目的としています。3つの主要な問題に対処します：エージェントが小さな情報のために全ファイルを読み込む傾向、再起動後にセッションメモリが失われる問題、そしてトークン予算を消費する冗長なBash出力のノイズ。

動作方法

このプロジェクトは、Model Context Protocol (MCP) サーバーとして動作し、複数の最適化層を提供します。

• 構造的ナビゲーション：全ファイルを読み込むのではなく、シンボル（関数、クラス、インポート、コールグラフ）でコードベースをインデックス化し、ポインタによるナビゲーションを可能にします。
• 永続的メモリ：SQLite（WAL + FTS5）とベクトル埋め込みの組み合わせを使用して、決定、バグ修正、コーディング規約を保存し、新しいセッションでコンパクトな差分として再注入します。
• Bash最適化：
  • PreToolUse リライター：実行前にBashコマンドを編集し、モデルに届く出力を小さく、より効率的なものにします。
  • PostToolUse コンパクター：git、docker、kubectlなどに特化した34種類の純関数型コンパクターを適用し、ツール出力をトークン効率よく表示します。これらのコンパクターは現在のターンのサイズを縮小しませんが、出力を「キャプチャサンドボックス」に完全に保持するため、コンテキスト圧縮にも耐えられます。
• プロファイル：optimized、tiny、full などの異なるツールマニフェストを提供し、モデルに公開されるツール数を制御することで、マニフェストのトークンをさらに削減します。

対象ユーザー

Claude Code、Cursor、Gemini、CodexなどのAIコーディングエージェントを使用している開発者で、トークンコストを下げたい、エージェントの応答速度を速めたい、そしてコーディングセッション間で永続的なメモリを維持したい人向けです。

主な特徴

• 顕著なトークン削減：tsbenchベンチマークでタスクあたりのアクティブトークンが80%削減されたと報告されています。
• シンボルベースのインデックス化：cat と grep の連鎖を直接的なシンボル検索に置き換えます。
• PreToolUse リライト：トークンの肥大化が発生する前に、コマンドを積極的に修正します。
• 永続的メモリエンジン：ベイジアン有効性とROIランク付けを用いて、長期的なプロジェクト知識を管理します。
• 広範なツールサポート：git、gh、pytest、aws-cliなど、一般的なCLIツール向けに34種類の専用コンパクターを備えています。