Implant – コーディングエージェントにVS CodeのAPIを公開する拡張機能
要約
Implantは、Visual Studio CodeのAPIをコーディングエージェント(Copilot Chat、Cursorなど)にリアルタイムで公開するVS Code拡張機能です。これにより、エージェントはエディタが持つFind References、Go-to-Definition、診断などの機能を直接利用できるようになります。ユーザーはスクリプトの実行前に確認するプロセスを経て、安全にコードの操作や分析を行うことができます。
全文翻訳
Implant
Implantを使用すると、AIコーディングアシスタントは、エディタが既に持つインテリジェンス(すべての言語サーバー、すべての拡張機能コマンド、さらにクロス言語の構造検索とリライトのためのast-grep)と同じように、コードを読み取り、編集できるようになります。
内部では、エージェントは短いJavaScriptスニペットを送信し、これがVS Code拡張機能ホスト内で、完全なvscode.* APIをスコープとして実行されます。ユーザーが正確なスニペットを承認しない限り、何も実行されません。
エディタが既に持つツールでコードを探索する: 参照の検索、定義への移動、ホバー時の型表示、ワークスペース診断、git blame、シンボルアウトライン、サードパーティ拡張機能が登録した任意のコマンド。
エディタを支えるのと同じ言語サーバーを通じてコードを変更する: 構造的なリネーム、クイックフィックスとリファクタリング、インポートの整理、WorkspaceEditを介した安全なファイル作成/リネーム/削除、フォーマッター出力、ソースアクション。編集は言語サーバーを経由します。これはファイルに対するsed/awkよりも安全です。なぜなら、スコープ、インポート、セマンティクスを尊重するからです。
ast-grepによる構造検索とリライト: ast-grepがサポートする任意の言語で、ワークスペース全体にわたるコード形状のすべての出現箇所を一度に見つけて変更します。正規表現がコメントや文字列リテラルで見誤るようなことはありません。
[画像: screenshot]
クイックスタート
- 拡張機能をインストールします。
- プロジェクトを開きます。Implantはワークスペースへの自己インストールを提案します。これにより、エージェントにいつImplantを利用すべきかを教えるポータブルなルールファイルが配置されます。
- エージェントはツールを自動的に認識します。MCPネイティブクライアント(Copilot ChatやVS Code ≥ 1.101上のその他)はレジストリ経由で検出し、CLIエージェントはステップ2でインストールされたワークスペースの指示から取得します。
- エージェントがツールを呼び出すと、エディタの横にWebビューが開き、構文ハイライト付きのスクリプトが表示されます。「実行」、「実行 + セッションを信頼」、「拒否」をクリックします。
Copilot Chatで直接@implantと入力してImplantに問い合わせることもできます。詳細は下記を参照してください。
Copilot Chatでの@implant
Copilot Chatで自然言語のリクエストとともに@implant …と入力します。Implantは言語モデルに、あなたの要求をvscode.*スニペットに翻訳させ、そのスニペットを表示し、他のどの呼び出しとも同じ承認フローで実行し、結果をチャットにストリーミングします。
UIでワンクリックではできないことの例:
@implant ワークスペース全体で、タグごとにグループ化された、クリック可能な file:line リンク付きの TODO / FIXME / HACK コメントをすべてリストアップしてください。@implant src/ のエクスポートされたシンボルで参照がゼロのものはどれですか?それらはデッドコード候補です。@implant 診断カウントで開いているタブをソートして、最初に修正すべきファイルを知れるようにしてください。@implant バグレポートのスナップショットを提供してください:VS Codeのバージョン、アクティブなユーザー拡張機能、開いているタブ、変更されていないファイル、および言語ごとの診断カウント。GitHub対応のMarkdown形式でフォーマットしてください。@implant このワークスペースで、ファイル間参照カウントが最も多い上位20個の関数をリストアップしてください。@implantfoo→barのプロジェクト全体のリネームがどこに影響するかをプレビューしてください — ファイル数とファイルごとの行数、変更は適用しません。
言語モデルにはGitHub Copilotが必要です。読み取り専用クエリとリファクタリングのドライランが最適な用途です。ファイルを変更するものはすべて承認Webビューを開くため、実行前に正確なスニペットを目視確認できます。
安全上の注意
- スニペットは、拡張機能自体と同じ権限でVS Code拡張機能ホストで実行されます。サンドボックスはありません — それがImplantの目的全体です。
- 承認Webビューは、実行前に各スニペットを目視確認できるように存在します。エージェントが既にタイトなレビューループに入っている場合にのみ、確認をオフにしてください。
- HTTPサーバーは
127.0.0.1にのみバインドし、セッションごとにベアラートークンが必要です。トークンは.vscode/implant/session.yml(モード0600、gitignore済み、アクティベーションごとに再生成)に保存されます。有効なトークンなしのリクエストは401を返し、ポートを試みるものを警告通知で知らせます。 - トークンゲートがあっても、共有マシンでこれを実行しないでください。あなたのユーザーとして実行されている任意のプロセスがセッションファイルを読み取ることができます。
implant.requireConfirmationワークスペース設定は、承認Webビューを切り替えます。これをオンのままにしておくのには理由があります。承認Webビューのセッションごとの「信頼」ボタンは、実行を積極的に監視している場合の脱出ハッチです。