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"]
             }
           }