From 1277f328c42c1e61f26717675b14f3e99627b2fe Mon Sep 17 00:00:00 2001
From: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Date: Fri, 14 Nov 2025 20:08:46 -0300
Subject: [PATCH] docs: Improve custom keybinding for external agent example
 (#42776)

Follow up to https://github.com/zed-industries/zed/pull/42772 adding
some comments to improve clarity.

Release Notes:

- N/A
---
 docs/src/ai/external-agents.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md
index 7830400fde45ba76029c2e50d02126b2a6278677..ade14c393dc5155d5b3cc68fa3597c643fbfe982 100644
--- a/docs/src/ai/external-agents.md
+++ b/docs/src/ai/external-agents.md
@@ -213,14 +213,14 @@ To assign a custom keybinding to start a new thread for agents that were added b
 ```json [keymap]
 {
   "bindings": {
-    "cmd-alt-n": [
+    "cmd-alt-n": [ // Your custom keybinding
       "agent::NewExternalAgentThread",
       {
         "agent": {
           "custom": {
-            "name": "My Agent",
+            "name": "My Agent", // The agent name as it appears in the UI (e.g., "OpenCode", "Auggie CLI", etc.)
             "command": {
-              "command": "my-agent",
+              "command": "my-agent", // The agent name in lowercase with no spaces
               "args": ["acp"]
             }
           }