Graftでコーディングエージェントにコードマップを追加
Graftはtree-sitterでリポジトリを解析し、MCP経由で検索できるコードベースマップを生成します。毎セッションの構造再探索を減らす仕組みと使い方を解説します。
コーディングエージェント向けコードベースマップとは
コーディングエージェント向けコードベースマップとは、リポジトリの永続的なインデックスです。エージェントはセッションのたびにゼロから grep を実行するのではなく、このインデックスを参照して情報を取得します。Graft はこの概念の実装の一つです。Graft は tree-sitter を使用してコードを解析し、リンクされたマークダウンノードのフォルダとシンボルごとの配線グラフを作成します。そして、MCP (model context protocol、コーディングエージェントが外部ツールを呼び出すための標準インターフェース) を介して検索ツールを提供します。
Graft はプロキシではなく、ゲートウェイでもありません。エージェントとモデル API の間に何かが介在することはありません。マップはエージェントが読み取るディスク上のフォルダです。この違いにより、解決する問題が異なります。セルフホスト型のトークンゲートウェイは、すでに送信しているリクエストを計測し、経路を振り分けます。一方、マップは送信する必要があるリクエストの総数を削減します。
この手法は本ツールよりも古く、今後も存続するものです。まずは手法を学び、その後に仕組みを理解してください。
コーディングエージェントが構造の再発見にコンテキストを消費する理由
すでに 50 回見たことのあるリポジトリで、エージェントが作業を始める様子を見てください。ディレクトリを一覧表示し、シンボルを grep し、関数を定義しているファイルを特定するために 3 つのファイルを開き、さらにその関数の呼び出し元を確認するために 4 つ目のファイルを開きます。これらはタスクそのものではありません。状況把握のための処理であり、セッションのたびに入力トークンを消費します。
原因は単純です。モデルにはセッション間の記憶がありません。エージェントがレイアウトについて学習した内容は、セッション終了時に破棄されるコンテキストウィンドウ内にしか存在しません。そのため、同じ探索が毎回ゼロから繰り返され、同じコストを再び支払うことになります。Prompt caching で割引されるのは、直近 5 分以内に見た同一のプロンプトプレフィックスだけです。追加料金を支払っても対象は直近 1 時間以内です。そのため、前日の探索結果を当日のセッションに引き継ぐことはできません。大規模なリポジトリでは、状況把握のコストが編集作業を上回ります。コードの場所を特定するために 10 回のツール呼び出しを行い、変更には 1 回しか使わないこともあります。このコストの半分が状況把握で、残りの半分が編集です。だからこそ、エージェントに動作する最小限の変更を守らせるスキルは、どちらか一方を選ぶのではなく、マップと組み合わせる価値があります。
マップを使うと、探索をモデルからディスクへ移すことで、このループを断ち切れます。パーサーがリポジトリを 1 回走査し、各シンボルがどこで定義され、どのシンボルを呼び出しているかを記録します。その後、コードの変更に合わせて記録を更新します。エージェントは 1 つの質問をするだけで、ファイルと行番号付きの回答を得られます。繰り返しの探索が、低コストな検索に変わります。
すでに、これより簡易な仕組みを使っています。規約を記載した AGENTS.mdがあれば、エージェントが毎回規約を再導出する必要はありません。生成されたマップがあれば、構造を再導出する必要がありません。違いは、誰が作成するかです。指示ファイルは手作業で記述するため、小さく保てます。パーサーはマップを生成するため、10,000 個のファイルを対象にできます。セッション内で実際に予算がどこへ使われるかについては、Claude Code がコンテキストウィンドウをどのように使うかで内訳を説明しています。
Graft が実際に構築するもの
リポジトリのルートにある 1 つの graft/ フォルダー内に、2 つの成果物を作成します。
1 つ目は、リンクされた markdown として記述されたノードグラフです。ノードごとに 1 ファイルを使用します。各ノードには、平易な英語による概要、ソースから抜き出した重要なロジック行の「核心」、コンテンツハッシュ付きの正確なソースファイル、他のノードへの型付き wikilink(depends_on、part_of、uses、implements)、そして再生成後も保持される notes セクションが含まれます。notes セクションには、パーサーが推測できないコンテキストを記録できます。
2 つ目は graft/.graph/wiring.json です。これは tree-sitter が抽出するシンボル単位の構造グラフで、定義、参照、定義間の呼び出しエッジを含みます。
この分離が重要なのは、モデルが必要なのは一方だけだからです。graft build は tree-sitter のみで処理され、LLM(大規模言語モデル)を呼び出しません。そのため、結果は決定的でコストもかかりません。graft build --deep は記述形式の概要とシンボル単位の核心を追加します。これらにはモデル呼び出しが必要で、利用料金が発生します。
言語サポートは段階化されており、その段階によってコールグラフをどこまで信頼できるかが決まります。TypeScript、JavaScript、Python、Go、Java、Kotlin、PHP、Swift、R では、スコープを考慮したファイル間解決が行われます。Rust、C、C++、C#、Ruby、Scala、Elixir、Solidity、OCaml、Zig、Dart、Clojure、Nix、Lua では、シンボルと汎用的な呼び出しエッジを取得します。つまり、エッジが解決済みの参照ではなく、名前の一致を示す場合があります。コンパイラー相当のエッジは、--lsp と rust-analyzer または gopls のような language server を使用して明示的に有効化できます。
Graft のインストールとバージョンの固定
Graft には Node.js 20 以降が必要で、MIT ライセンスで提供されています。2026 年 10 月 17 日時点の最新リリースは 0.23.0 です。これは 2026 年 10 月 15 日に公開されました。最初の公開バージョンは 0.1.0 で、2026 年 7 月付けです。まだ新しいソフトウェアとして扱ってください。2026 年 10 月 14 日に公開された 0.22.0 では、プロジェクト名が Trail-code に変更されました。同じコードが現在は @trailhq/trail-code としても提供され、trail コマンドを使用します。一方、@nanonets/graft では graft コマンドが維持されています。
このガイドでは、2026 年 9 月 29 日に公開され、名称変更前の最後のリリースである 0.21.1 に固定します。0.22 と 0.23 では、このガイドが依存するコマンドが変更されたためです。0.22 以降、graft check はブランチの差分をリポジトリのチームの学習内容と比較し、競合があると 1 で終了します。ドリフト検出は graft build --check に移動し、MCP ツールの名前は trail_* になりました(サーバーは従来の graft_* 名にも応答します)。0.23.0 の changelog には、trail で設定したリポジトリでは map が .trail/cache/ に移動し、Claude Code が MCP server を受け取らなくなると記載されています。一方、README では依然として graft/ と .mcp.json が説明されています。pin を変更する前に changelog を読み、--dry-run を実行してください。
npm install -g @nanonets/graft@0.21.1
npm ls -g @nanonets/graftnpm ls -g は @nanonets/graft@0.21.1 を出力するはずです。このバージョンを意図的に固定してください。単独の npm install -g @nanonets/graft は、実行時点の latest tag を解決します。1 か月に複数の minor release が公開されるプロジェクトでは、これにより、月曜日に同僚がインストールしたツールと火曜日に自分が使うツールが異なる可能性があります。バージョンを固定すると、CLI flag と graph format を全員で同じに保てます。そのため、アップグレードするタイミングを自分で決められます。
次に、自分が所有するリポジトリへ組み込みます。
cd /path/to/your/repo
graft init --dry-run
graft initgraft init は、接続する coding agent を選択するよう求め、その後 graph を構築します。まず --dry-run を実行し、変更対象として計画されているファイルの一覧を確認してください。一部のファイルはリポジトリの外側にあるためです。graft init は冪等性があり、既存の設定を上書きしません。そのため、2 回目に実行しても安全です。元に戻すには graft uninstall を使用します。これは -y を渡すまで dry run です。
同じプロンプトには telemetry のチェックボックスもあります。release 0.12.0 以降、Graft はデフォルトで匿名の使用状況 ping を送信します。送信されるのはバケット化した件数と固定ラベルだけで、コード、ファイルパス、リポジトリ名は送信されません。イベントの送信は 1 日に 1 回までです。ただし、install event は例外です。これは npm の postinstall hook によって background sender に直ちに渡されます。graft init 中にチェックを外すか、graft telemetry disable を実行するか、DO_NOT_TRACK=1 を設定して無効にしてください(CI では自動的に無効になります)。graft telemetry debug を実行すると、送信せずに送信予定の batch を出力できます。
0.21.1 では、Claude Code、Cursor、Codex、GitHub Copilot、Google Gemini、Kiro、Windsurf、Grok (xAI)、AdaL、Hermes Agent、Google Antigravity の wiring に対応しています。Hermes Agent は release 0.13.0 以降、first-class の graft init host です。固定したバージョンでは、graft init --agents hermes と graft init --agents antigravity により、他の host と同じようにこの 2 つを選択できます。Grok は release 0.13.0 で追加され、graft init --agents grok で選択します。Claude Code との統合が最も深く、MCP server entry、graph のサイズと古さを表示する statusline、graph を再構築する post-edit hook、.claude/ 配下の skill file が追加されます。その他の agent には、ツールが存在することを伝える instruction または rule file が追加されます(Hermes Agent と Antigravity はどちらも AGENTS.md セクションを読み取ります)。また、Grok には独自の設定内に MCP block も追加されます。したがって、「supported」とは Graft が wiring を書き込むという意味です。agent 自身が rule file を読み飛ばせば、map も読み飛ばします。これは通常、agent が自分向けに書かれた指示を無視する理由です。この点はここでも同じです。
リポジトリに入り、git の対象外になるもの
graft initの実行後は、次の状態になります。
graft/: markdown のノードグラフとgraft/.graph/wiring.json。.gitignoreに自動で追加されます。.mcp.json: graft MCP server を登録し、Claude Code が起動時に実行できるようにします。.claude/settings.json: 既存の内容にマージされ、statusline と post-edit hooks が追加されます。AGENTS.md、GEMINI.md、.github/copilot-instructions.md、.cursor/rules/graft.mdc、.kiro/steering/graft.md、.windsurf/rules/graft.md、.grok/skills/graft/SKILL.md、.adal/skills/graft/SKILL.md: 選択した agents に対応するファイルへ、marker-fenced sections として追記されます。.grok/config.toml: リポジトリレベルの[mcp_servers.graft]ブロック。Grok を選択した場合だけ書き込まれます。~/.codex/config.toml、~/.codex/hooks.json、~/.codex/hooks/graft/graft-hooks.cjs: マシン全体に適用されます。Codex を選択し、~/.codex/がすでに存在する場合だけ書き込まれます。graft init --no-globalはこれらを省略し、graft init --no-hooksは hook shim だけを単独で省略します。
グラフは node_modules と同様にキャッシュです。コミットしないでください。コードから数秒で再生成でき、ほぼすべての編集で変更されます。コミットすると、1 行の修正が数百ファイルに及ぶ差分になり、レビュー担当者が確認しない差分まで発生します。代わりに、AGENTS.mdや .mcp.json などの連携設定をコミットします。チームメンバーはリポジトリを clone し、graft buildを実行して、自分のローカルグラフを取得できます。
最初のコミット前に、ignore ルールが追加されたことを確認します。
grep -n graft .gitignore
git status --shortgrepは graft/を含む行を出力し、git status --shortは graft/配下を何も一覧表示しないはずです。その出力に graft/配下のファイルが表示される場合、ignore エントリが存在しないか、別の場所で上書きされています。コミット前に修正してください。git は一度追加したファイルの追跡を継続するため、後から .gitignoreを編集しても追跡対象から外れません。
MCP server を手動で登録する場合や、インストールしたものと同じバージョンに固定する場合は、エントリは次のように小さく記述できます。
{
"mcpServers": {
"graft": {
"command": "npx",
"args": ["-y", "@nanonets/graft@0.21.1", "mcp"]
}
}
}grep の代わりにエージェントが呼び出す検索ツール
Graft は MCP 経由で 6 つのツールを公開します。graft_find_code は、タスクの説明に対してスコア順に並べたノードを、ファイルと行番号付きで返します。graft_file_api は、本文を含めずにファイル内のすべてのシグネチャを返します。graft_trace_calls は、呼び出し元または呼び出し先を複数の階層にわたってたどります。graft_find_all は、正規表現の一致箇所をシンボルごとにまとめて返します。graft_repo_map は、不慣れなリポジトリを最初に把握するための情報を返します。graft_check_freshness は、グラフが現在もコードと一致しているかを報告します。
すべてのツールには CLI 版もあります。これを使うと、エージェントに実際に渡されている内容を確認できます。
graft map .
graft ask "where do we validate the refresh token"
graft skeleton src/auth/session.ts
graft callers validateRefreshToken
graft callers validateRefreshToken --direction out
graft grep "refresh_token" --jsongraft ask は、ファイルの内容ではなく、file:line の参照付きでスコア順のノードを表示するはずです。仕組みはこれだけです。エージェントはポインターを受け取り、適切なファイルを探すために 10 個のファイルを読むのではなく、1 個のファイルを開きます。グラフを自分で確認したい場合は、graft viz で localhost 上のインタラクティブビューアーを開けます。30 秒で答えられる質問に対して graft ask が役立つ結果を返さなくても、質問を書き換えて再実行しないでください。スコア順の検索では見落としが発生することがあり、プロジェクト固有の skill ファイルにも、ヒットが弱い場合は graft grep、graft skeleton、または graft callers に切り替えるよう記載されています。それでも不十分な場合は、ドリフトを確認してください(固定した 0.21.1 では graft check .、0.22 以降では graft build --check)。また、使用している言語がどの tier に属するかも確認してください。古いグラフや広すぎる tier のエッジがあると、同じようにエージェントが機能しなくなります。
見落としやすいコストが 1 つあります。6 つのツール定義は、セッション全体にわたって、すべてのリクエストの system prompt に注入されます。エージェントがマップを使うかどうかに関係なく、そのコストが発生します。コンテキストに収まるほど小さいリポジトリでは、固定コストのほうが、探索によって削減できるコストを上回る場合があります。
コードが変更されるとグラフに何が起きるか
構造の更新は低コストで自動的に行われます。Graft は git ではなく作業ツリーを読み取るため、まだコミットしていない編集も、ステージングした編集も同じように認識します。各クエリでは、まず作業ツリーの状態を確認し、変更されたファイルだけを再解析します。0.21.1 のドキュメントでは、何も変更されていない場合のこの確認にかかる時間を約 3 ms としています。現在の README では数十ミリ秒、プロジェクト自身のリポジトリでは約 50 ms と記載されています。ターン終了時の再構築では、コードが移動したファイルだけが処理されます。GRAFT_NO_REFRESH=1 を設定するか、--no-refresh を渡すと、再解析せずにディスク上のグラフから回答します。--no-reuse を渡すと、すべてをコールド再解析します。これは Graft 自体をアップグレードした後に使用します。
モデルが作成した部分は異なる動作をし、静かに問題が発生するのはこちらです。要約と核心部分はキャッシュされます。各ノードにはソースのコンテンツハッシュが記録されます。そのため、ソースファイルが変更されると、ノードは最新として扱われるのではなく、古い状態としてマークされます。このフラグは、何らかの処理が行われる場合にだけ役立ちます。graft build --deep で更新すると、モデルのトークンが再び消費されます。
古い状態を確認できるようにします。
graft check .
echo $?固定した 0.21.1 では、終了ステータス 0 はグラフとコードが一致していることを示し、終了ステータス 1 は差分があることを示します。0.22 以降では、graft check は代わりにチームの学習との競合がある場合に 1 で終了し、差分の検査には graft build --check を使用します。そのため、固定するバージョンを変更したらコマンドも変更してください。pre-push hook から実行すると、6 か月前のマップが、3 月に書き換えられたコードについて確信を持って回答することを防げます。0.21.1 の README では、graft check をローカルの最新性を示すシグナルとして説明しています。現在の README では、CI 用に build --check を記載しています。いずれの場合も graft/ は git-ignored であるため、ジョブがグラフを構築しない限り、新しい CI checkout はグラフなしで開始されます。
公開されているベンチマークの数値を注意深く読む
0.21.1 の README では、「最大で 4 倍安く、3 倍速く、正確性は改善または低下なし」と最初に掲げていました。現在の README ではこの文が削除され、より小さい数値が先に示されています。「同じタスクで同じエージェントを 162 回実行した結果、コスト 32% 削減、キャッシュされていない入力トークン 42% 削減、所要時間 60% 短縮、正解の割合は同じ」。これらは、プロジェクトが README で公開している独自ベンチマークの結果です。ここでは、同プロジェクトが完全な形で報告している 2 つの実行結果を示します。
このグラフのデータ
[
{
"label": "Controlled sweep",
"run_count": 162,
"token_saving_pct": 42,
"tool_call_saving_pct": 46,
"correctness_pct": 93,
"baseline_correctness_pct": 93
},
{
"label": "SWE-bench Verified",
"run_count": 50,
"token_saving_pct": 23,
"tool_call_saving_pct": 25,
"correctness_pct": 66,
"baseline_correctness_pct": 54
}
]制御されたスイープは、2 つのリポジトリに対する 162 回の実行です。そのうち 1 つは Graft 自身で、各タスクを 3 回試行しています。キャッシュされていない入力トークンが 42% 少なく、ツール呼び出しが 46% 少ないと報告されています。SWE-bench Verified の実行は、両方の条件で同じモデルを使用した 50 インスタンスで、削減幅はより小さく、トークンは 23%、ツール呼び出しは 25% です。PocketBase の 15 タスクに対する 3 回目の実行では、開発者からの質問 10 件と、マージ済みプルリクエストを再現したもの 5 件を対象とし、ベースラインの 13.91 US dollars に対して、合計 11.02 US dollars かかりました。
これらはすべてベンダーによるベンチマークとして扱ってください。ここから分かることには、2 つの制約があります。制御されたスイープには Graft 自身のリポジトリが含まれています。これは、開発者が最適化の対象にしたコードベースです。SWE-bench Verified は、よく知られたオープンソースの Python プロジェクトから収集した問題の公開データセットです。公開データセットは、意図の有無にかかわらず、ツールが最適化する対象になります。どちらも、固有の命名規則と独自のデッドコードを持つ、あなたのプライベートモノレポについての結果ではありません。
正確性については、もう一度確認する必要があります。制御されたスイープでは変化しておらず、map を使用した場合は 93%、使用しない場合は 93% でした。54% から 66% への上昇が見られるのは、SWE-bench Verified の場合だけです。トークン料金を削減し、品質を一定に保てるツールは、それでも十分に価値のある選択です。ただし、SWE-bench の正確性の結果をスイープのトークン結果にそのまま当てはめ、両方を 1 つの主張として引用しないでください。
自分のトークン差分を測定してから判断してください
重要なのは、リポジトリから得られた数値だけです。この方法は半日で実施できます。
完全に同じ手順を繰り返せるタスクを選びます。編集ではなく質問が適しています。編集を行うとリポジトリが変わり、2 回目の実行が同じ実験にならないためです。「ログインルートのレート制限を適用しているモジュールはどれか」という形式が適しています。
テレメトリを有効にし、自分のターミナルへ送信します。
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
claudeコンソールエクスポーターは、収集したメトリクスレコードをそのまま出力します。確認するのは claude_code.token.usage です。このレコードには、type 属性として input、output、cacheRead、または cacheCreation が含まれます。ファイル内容が出力されるため、オリエンテーションは input と cacheRead に現れます。この 2 つを合計します。
マップを接続した状態で、タスクを新しいセッションごとに 3 回実行します。次に .mcp.json から graft エントリを削除し、さらに 3 回実行します。1 回の実行結果ではなく中央値を比較します。エージェントの実行結果には大きなばらつきがあり、たまたま不運な 1 回の実行によって、正反対の結論に至ることがあるためです。ツール呼び出し回数も記録します。ツール呼び出しは仕組みであり、トークンは結果です。そのため、ツール呼び出し回数が減っていないのにトークンだけが削減された場合は、別の要因が変化しています。
次に、ベンチマークに表示されないコストを差し引きます。graft build --deep は、完全な更新のたびにモデルのトークンを消費します。6 個のツールスキーマも、すべてのリクエストに含まれます。エージェントをレンタルしたサーバー上で実行している場合は、エージェントの支出に上限を設定することで、予期しない支出を予算として管理できます。また、エクスポーターを有効にした後にマシンから送信される情報については、コーディングエージェントのテレメトリが実際に報告する内容を参照してください。
コードベースのマップが役に立たなくなるのはどのような場合ですか?
- リポジトリ全体がコンテキストに収まる。 小規模な単一サービスにマップは不要です。リクエストごとに6つのツールスキーマのコストも発生します。現在、エージェントが1回か2回のツール呼び出しで任意のファイルを見つけられるなら、マップを使う必要はありません。
- 使用言語が広範なカテゴリに含まれる。 汎用的な呼び出しエッジでは、
graft callersが呼び出し元を見落としたり、名前の衝突から存在しない呼び出し元を生成したりする可能性があります。影響範囲を信頼する前に、graft grepで確認してください。 - グラフが古くなっているのに、誰も気付いていない。 0.21.1ではドリフトがあると
graft checkが終了コード1で終了します(0.22以降ではgraft build --checkが終了コード1で終了します)。ただし、何かが実行しなければ意味がありません。習慣に頼るのではなく、pre-push hookで実行してください。 - monorepoでスコープ指定が必要になる。 単一のgit monorepoは分割されません。ただし、
graft buildはpnpm-workspace.yaml、package.jsonworkspaces、またはパッケージごとのgo.mod、pyproject.toml、Cargo.tomlからサブプロジェクトを検出し、それらをランキングのスコープとして使用します。また、graft ask "..." --in services/billing/でクエリを1つのサブプロジェクトに絞り込めます。パッケージごとにネストしたAGENTS.mdファイルを置くという考え方は、マップにも当てはまります。 - エージェントが配線を無視している。 マップが使われていると判断する前に、実際のセッションでツール呼び出しを確認してください。エージェントが引き続き
grepを実行しているなら、ルールファイルを一度も読んでいないということです。
FAQ
graft/ フォルダーを git にコミットすべきですか?
いいえ。graft build は node_modules と同様にグラフを再生成可能なキャッシュとして扱うため、graft/ を .gitignore に自動的に追加します。ほぼすべての編集で変更されるため、コミットすると生成ファイルが数百個発生し、本来の差分が埋もれます。マップの存在をエージェントに伝える設定をコミットしてください。AGENTS.md と .mcp.json もその一部です。各チームメイトには、graft build をローカルで実行してもらいます。最初のコミット前に grep -n graft .gitignore と git status --short で確認してください。git は一度追加したファイルの追跡を継続するため、後から .gitignore を編集しても追跡は解除されません。
Graft の実行には費用がかかりますか?
構造解析部分にはかかりません。graft build、graft ask、graft check、および 6 個の MCP 取得ツールは tree-sitter の処理であり、モデルを呼び出しません。graft build --deep が有料部分です。LLM を使って平易な英語による要約とシンボルごとの要点を生成します。GRAFT_PROVIDER、GRAFT_API_KEY、GRAFT_MODEL で設定し、OpenAI 互換エンドポイントには GRAFT_BASE_URL も使用します。構造解析だけで Graft を実行すれば、グラフ自体にトークンを使う必要はありません。
コードベースのマップは、実際に自分のリポジトリでどれだけ節約できますか?
測定しなければ誰にも分かりません。プロジェクトの報告では、独自の 162 回の実行による調査で、マップなしのベースラインと比べてキャッシュされていない入力トークンが 42% 少なくなりました。SWE-bench Verified では 23% 少なくなりました。どちらもベンダーによるベンチマークです。そのうち 1 つは Graft 自身のリポジトリで一部実行されています。いずれもあなたの非公開コードについて説明するものではありません。再現可能な質問を 1 つ選び、マップありで 3 回、マップなしで 3 回実行してください。その際、CLAUDE_CODE_ENABLE_TELEMETRY=1 と OTEL_METRICS_EXPORTER=console を設定します。次に、input 型と cacheRead 型について、claude_code.token.usage の中央値を比較します。
リファクタリングするとグラフはどうなりますか?
構造情報は自動的に再解析されます。Graft は作業ツリーを調べ、変更されたファイルだけを再解析するため、名前の変更は次のクエリで反映されます。何も移動していない場合、この確認にかかる時間は 0.21.1 ではおよそ 3 ms、現行リリースでは数十 ms です。また、git の履歴ではなくファイルを読み取るため、コミットしていない変更も検出します。古くなるのはモデルが生成した要約です。各ノードにはソースのコンテンツハッシュが保存され、ソースが変更されるとノードは書き換えられずに stale とマークされます。ドリフトを確認してください。0.21.1 では graft check .、0.22 以降では graft build --check を使用します。その後、graft build --deep を実行して生成済みの部分を更新します。
現在、どのコーディングエージェントが Graft を使用できますか?
固定された 0.21.1 では、graft init により Claude Code、Cursor、Codex、GitHub Copilot、Google Gemini、Kiro、Windsurf、Grok (xAI)、AdaL、Hermes Agent、Google Antigravity が接続されます。合計 11 個のホストです。変更履歴では 0.13.0 以降、Hermes Agent が正式なホストとして記載されています。また、固定リリースでは hermes と antigravity は通常の --agents ID です。Claude Code には最も多くの設定が提供されます。.mcp.json の MCP サーバーエントリ、ステータスライン、編集後フック、.claude/ 配下のスキルファイルです。Codex には AGENTS.md セクションと、~/.codex/ 配下のマシン全体向けエントリがあります。ただし graft init --no-global は後者を省略します。Grok にはスキルファイルと .grok/config.toml の MCP ブロックがあります。Hermes Agent と Antigravity は AGENTS.md セクションを読み込みます。その他のエージェントにはルールファイルまたはステアリングファイルが提供されます。その他の MCP クライアントでも、npx -y @nanonets/graft@0.21.1 mcp コマンドを登録すればサーバーを直接使用できます。