diff --git a/README.ja.md b/README.ja.md
index 5bf105f..f30cc6c 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -63,6 +63,12 @@ loopfinder が置くものは2つのフォルダだけです。`loopfinder/`（
 `AGENTS.md` は、入っている loopfinder の版に合わせて毎回書き直されます。手で直しても、次の実行で消えます。
 画面は `127.0.0.1` でだけ待ち受けます（グラフにはファイルのパスが並ぶため）。画面では、英語と日本語、配色（自動＝OS に合わせる・ライト・ダーク）を切り替えられ、どちらの選択もブラウザが覚えます。
 
+### VS Code で使う
+
+同じ CLI と画面を拡張機能にしたものがあります: [Visual Studio Marketplace の loopfinder](https://marketplace.visualstudio.com/items?itemName=motimotinotch.loopfinder)。
+エディタに入っている実行環境で動き（Node は不要）、画面はタブで開いてビルドのたびに描き直し、パスを押すとそのファイルが開きます。
+ワークスペースを信頼するまで、準備とビルドは使えません。詳しくは [vscode/README.ja.md](vscode/README.ja.md)。
+
 ## flows.json
 
 書くのはエージェントで、人は読んで、必要なら直します。エージェントが従う規則の全文は、案内書の元 [`src/agents-guide.md`](src/agents-guide.md) にあります。
diff --git a/README.md b/README.md
index 85e6427..a465cbb 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,13 @@ in version control) and `.loopfinder/` (the build output, which lists your file
 `AGENTS.md` is rewritten on every run so it follows the installed version; edit it and the edit is lost.
 The viewer listens on `127.0.0.1` only: the graph lists your file paths. It can switch between English and Japanese and between auto (follow the system), light and dark; both choices are remembered by the browser.
 
+### In VS Code
+
+The same CLI and viewer as an extension: [loopfinder on the Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=motimotinotch.loopfinder).
+It runs on the editor's own runtime (no Node install), opens the viewer in a tab that redraws after every
+build, and opens a file when you click its path. Set up and build are off until you trust the workspace.
+See [vscode/README.md](vscode/README.md).
+
 ## flows.json
 
 The agent writes it; you read it (and can correct it). The full rules the agent follows are in the