diff --git a/website/docs/user-guide/features/acp.md b/website/docs/user-guide/features/acp.md
index 3b1dce824e..1822f7adfa 100644
--- a/website/docs/user-guide/features/acp.md
+++ b/website/docs/user-guide/features/acp.md
@@ -67,18 +67,24 @@ Hermes logs to stderr so stdout remains reserved for ACP JSON-RPC traffic.
 
 ### VS Code
 
-Install an ACP client extension, then point it at the repo's `acp_registry/` directory.
+Install the [ACP Client](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client) extension.
 
-Example settings snippet:
+To connect:
+
+1. Open the ACP Client panel from the Activity Bar.
+2. Select **Hermes Agent** from the built-in agent list.
+3. Connect and start chatting.
+
+If you want to define Hermes manually, add it through VS Code settings under `acp.agents`:
 
 ```json
 {
-  "acpClient.agents": [
-    {
-      "name": "hermes-agent",
-      "registryDir": "/path/to/hermes-agent/acp_registry"
+  "acp.agents": {
+    "Hermes Agent": {
+      "command": "hermes",
+      "args": ["acp"]
     }
-  ]
+  }
 }
 ```