Mibayy/token-savior

これは何？

主な機能

• 01find_symbolやコールグラフ上の依存先検索を含む、シンボル単位のコードナビゲーション
• 02全文検索とオプションのベクトル検索に対応した、SQLiteベースの永続メモリ
• 03モデルに届く前にコマンド出力を減らすPreToolUse Bashリライター
• 04git、テストランナー、クラウドCLI、Docker向けの34種類のPostToolUseコンパクター
• 05設定可能なツールプロファイルと、Claude Code、Cursor、Gemini、Codex、OpenClaw向けの`ts init`コマンド

ユースケース

• エージェントが小さなコード片を探すためにファイル全体を何度も読み直してしまう、大規模なコードベースでの作業
• 複数のClaude Codeセッションをまたいで、アーキテクチャ上の判断やバグ修正のメモを参照できるようにする
• ナビゲーションやテストを繰り返すエージェントのトークンコストとレイテンシを削減する
• Cursorやスクリプトなどの非MCPツールから、ts CLI経由でシンボル検索を利用できるようにする

クイックスタート

1. 1

   MCP サポート付きで PyPI からパッケージをインストールします

   pip install "token-savior-recall[mcp]"
2. 2

   ワークスペースのルートとプロファイルを指定して、MCP 設定（例: Claude Code）にサーバーを追加します

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

• !主要なベンチマーク数値は作者による報告であり、ハーネスのリポジトリも公開されていないため、独立した検証はできません。
• !Claude Code のユーザーは alwaysLoad を true に設定する必要があります。そうしないと、ツールが ToolSearch の背後に隠れ、ほとんど使われません。
• !PostToolUse の Bash コンパクターは現在のターンのトークン数を減らしません。減らせるのは PreToolUse のリライターだけです。

収録されている特集

トピック

よくある質問

token-savior とは？

コードをシンボル単位でインデックス化し、永続メモリとBashコマンドの書き換えでトークン使用量を削減する、AIコーディングエージェント向けMCPサーバー。 Token Saviorは、Claude CodeなどのAIコーディングエージェントとコードベースの間に配置するMCPサーバーです。限定的な質問に答えるためにモデルがファイル全体を読む代わりに、プロジェクトをシンボル（関数、クラス、インポート、コールグラフ）単位でインデックス化します。そのため、ファイル全体を読み込まず、ポインターを使って定義や依存するコードを検索できます。

token-savior は無料で使えますか？ライセンスは？

token-savior は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

token-savior は今もメンテナンスされていますか？

活発にメンテナンス中。token-savior の最終コミットは 2026年10月15日 です。

token-savior は何に使えますか？

エージェントが小さなコード片を探すためにファイル全体を何度も読み直してしまう、大規模なコードベースでの作業 複数のClaude Codeセッションをまたいで、アーキテクチャ上の判断やバグ修正のメモを参照できるようにする ナビゲーションやテストを繰り返すエージェントのトークンコストとレイテンシを削減する Cursorやスクリプトなどの非MCPツールから、ts CLI経由でシンボル検索を利用できるようにする

token-savior のインストール方法は？

MCP サポート付きで PyPI からパッケージをインストールします: pip install "token-savior-recall[mcp]" ワークスペースのルートとプロファイルを指定して、MCP 設定（例: Claude Code）にサーバーを追加します

token-savior はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Mibayy/token-savior