$ features
BoostGraph
仕組み
BoostGraph はコードベースを読み取り、何が何を呼び出すか、ファイルのつながり、主要ロジックの所在といった全体像のローカルマップを構築します。エージェントはファイルを1つずつ探さずに構造の質問に答えられます。
エージェントの問い合わせ方法
BoostGraph は MCP サーバーとして動作し、対応エージェントが自然言語でコードベースを問い合わせるツールを提供します — 手動のファイル検索は不要です。
シームレスな索引化
索引化はバックグラウンドで行われます。boost init を実行すると、Boost は対応コーディングエージェントにフックを登録します。各セッション開始時にフックがインデックスを確認します:
- リポジトリ初回:
.boost/を作成し、作業中に静かにグラフを構築 - 以降のセッション: 現在のツリーに合わせてインデックスを同期
- コード変更後: ローカルファイルウォッチャーがインデックスを最新に保つ
大規模コードベースでは初回索引に時間がかかることがありますが、バックグラウンドで実行されエージェントの妨げになりません。インデックスが準備できれば、エージェントは boostgraph_explore を使え、BoostGraph の恩恵を受けられます。
事前に手動で索引化するには、リポジトリディレクトリで boost graph init を実行します。
BoostGraph の使い方
boost initを実行 — 一度だけ。エージェントに Boost を接続します（セッション開始フック、MCP 設定）。その後エージェントを再起動してください。- コードベースをエージェントで開く — 索引化はバックグラウンドで自動開始されます。大規模リポでは初回索引の完了を待つか、
boost graph initで事前構築してください。 - 構造の質問をする — フロー、アーキテクチャ、呼び出し元/先。エージェントは長い grep/Read ループの代わりに
boostgraph_exploreを使うべきです。
メリット
- より速い回答 — 数十の探索ステップの代わりに1〜数回のツール呼び出し
- 精密なコンテキスト — ディレクトリ全体ではなく、正確なシンボルと呼び出しパス
- コスト削減 — 探索オーバーヘッドが減り、セッションあたりのトークンが減る
- 100% ローカル — API キー不要、データはマシンから出ない
- 30以上の言語 — Go、Python、TypeScript、Java、Rust、C# など
デモ動画
比較: grep/Read 探索 vs. BoostGraph。
ベンチマーク: Minikube ランタイム preflight フロー
kubernetes/minikube での深いフロー追跡の質問における、BoostGraph あり / なし のエージェント性能:
ホストにインストールまたは有効化されていないコンテナランタイムでクラスタを作成しようとしたとき、Minikube 内部で何が起きるか？preflight 検証、欠落ランタイムの検出、自動フォールバックまたはダウンロード、終了前のエラー形式を追跡してください。
| 指標 | BoostGraph なし | BoostGraph あり | 改善 |
|---|---|---|---|
| Cost | $0.2189 | $0.1071 | ~51% lower |
| Time | 1m 58s | 37s | ~3.2× faster |
| Input tokens | 2.3K | 632 | ~73% fewer |
| Output tokens | 10.7K | 3.3K | ~69% fewer |
| Cache read tokens | 689.2K | 180.5K | ~74% fewer |
| Cache write tokens | 68.8K | 36K | ~48% fewer |
トラブルシューティング
BoostGraph が初期化されていない
boost init でセッション開始フックを登録し、コーディングエージェントでプロジェクトを開いてください — 索引化は自動で開始されます。すぐに索引化するにはリポジトリルートで boost graph init を実行します。
索引化が遅い
大規模リポの初回索引は時間がかかりますが、バックグラウンドで実行されエージェントをブロックしません。
エージェントが BoostGraph の代わりに grep を使う
インデックスがまだ構築中か、索引化進行中のため MCP が未接続の可能性があります。エージェントを再起動し、/mcp で MCP 接続を確認してください。