From d509d4654650fa864061f30a12121d3494164364 Mon Sep 17 00:00:00 2001
From: blockmandev <194144408+blockmandev@users.noreply.github.com>
Date: Thu, 22 Oct 2026 16:28:28 -0600
Subject: [PATCH] docs: setting up Zed and JetBrains IDEs to run incode over
 ACP (refs #26)

incode --acp is a standard ACP agent, but the README named only the VS Code
extension, so a Zed or JetBrains user had to work out the client side alone.
Adds the settings each editor documents for a custom ACP agent: Zed's
agent_servers entry ("type": "custom", command, args, env) and the
JetBrains AI Assistant ~/.jetbrains/acp.json, with the PATH and Windows
backslash notes. The process side was checked by spawning `incode --acp`
the way both do and running an editor's initialize + session/new; the
editors themselves have not been tried, as the text says.
---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
index 35c4e49..10461f7 100644
--- a/README.md
+++ b/README.md
@@ -335,6 +335,32 @@ HTTP), which incode connects itself — in the background, so `session/new` does
 not wait for them — and runs through the same gate as its own tools.
 Details: `docs/ARCHITECTURE.md` §2.
 
+**Editors over ACP.** Any ACP client can run `incode --acp`. `incode` must
+be on the editor's `PATH`, or give its full path as `command` (on Windows,
+escape the backslashes in JSON: `"C:\\Users\\you\\.local\\bin\\incode.exe"`).
+
+- **VS Code:** the extension in [`editors/vscode`](editors/vscode/README.md).
+- **Zed:** Agent Settings → External Agents → Add Agent → Add Custom Agent,
+  then in `settings.json`:
+
+  ```json
+  "agent_servers": {
+    "incode": { "type": "custom", "command": "incode", "args": ["--acp"], "env": {} }
+  }
+  ```
+
+  Start a thread with it from the agent selector or the new-thread menu.
+- **JetBrains IDEs** (AI Assistant): AI Chat → the more-actions menu → Add
+  Custom Agent, which opens `~/.jetbrains/acp.json`:
+
+  ```json
+  { "agent_servers": { "incode": { "command": "incode", "args": ["--acp"], "env": {} } } }
+  ```
+
+Add `-p read-only` (or another mode) or `-m <model>` to `args` to fix them for
+the editor's sessions. These snippets follow each editor's documentation;
+report anything that differs in your editor on #26.
+
 ## Choosing agents and models
 
 incode builds one catalogue of agents at session start: