From cba239bc8fa5513e30174c4455397f26a4ed9b97 Mon Sep 17 00:00:00 2001
From: Aiden Cline <aidenpcline@gmail.com>
Date: Thu, 20 Nov 2025 14:01:02 -0600
Subject: [PATCH] change default child session cycle keybind to <leader>right,
 and <leader>left

---
 packages/opencode/src/config/config.ts                        | 4 ++--
 packages/sdk/python/src/opencode_ai/models/keybinds_config.py | 4 ++--
 packages/web/src/content/docs/agents.mdx                      | 4 ++--
 packages/web/src/content/docs/keybinds.mdx                    | 4 ++--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/packages/opencode/src/config/config.ts b/packages/opencode/src/config/config.ts
index c40a910e0..f5b402e36 100644
--- a/packages/opencode/src/config/config.ts
+++ b/packages/opencode/src/config/config.ts
@@ -428,8 +428,8 @@ export namespace Config {
       input_newline: z.string().optional().default("shift+return,ctrl+j").describe("Insert newline in input"),
       history_previous: z.string().optional().default("up").describe("Previous history item"),
       history_next: z.string().optional().default("down").describe("Next history item"),
-      session_child_cycle: z.string().optional().default("ctrl+right").describe("Next child session"),
-      session_child_cycle_reverse: z.string().optional().default("ctrl+left").describe("Previous child session"),
+      session_child_cycle: z.string().optional().default("<leader>right").describe("Next child session"),
+      session_child_cycle_reverse: z.string().optional().default("<leader>left").describe("Previous child session"),
     })
     .strict()
     .meta({
diff --git a/packages/sdk/python/src/opencode_ai/models/keybinds_config.py b/packages/sdk/python/src/opencode_ai/models/keybinds_config.py
index 05053206d..f98b3b78e 100644
--- a/packages/sdk/python/src/opencode_ai/models/keybinds_config.py
+++ b/packages/sdk/python/src/opencode_ai/models/keybinds_config.py
@@ -81,8 +81,8 @@ class KeybindsConfig:
     session_unshare: Union[Unset, str] = "none"
     session_interrupt: Union[Unset, str] = "esc"
     session_compact: Union[Unset, str] = "<leader>c"
-    session_child_cycle: Union[Unset, str] = "ctrl+right"
-    session_child_cycle_reverse: Union[Unset, str] = "ctrl+left"
+    session_child_cycle: Union[Unset, str] = "<leader>right"
+    session_child_cycle_reverse: Union[Unset, str] = "<leader>left"
     messages_page_up: Union[Unset, str] = "pgup"
     messages_page_down: Union[Unset, str] = "pgdown"
     messages_half_page_up: Union[Unset, str] = "ctrl+alt+u"
diff --git a/packages/web/src/content/docs/agents.mdx b/packages/web/src/content/docs/agents.mdx
index c99988ad8..3dd7f292e 100644
--- a/packages/web/src/content/docs/agents.mdx
+++ b/packages/web/src/content/docs/agents.mdx
@@ -89,8 +89,8 @@ A general-purpose agent for researching complex questions, searching for code, a
      ```
 
 3. **Navigation between sessions**: When subagents create their own child sessions, you can navigate between the parent session and all child sessions using:
-   - **Ctrl+Right** (or your configured `session_child_cycle` keybind) to cycle forward through parent → child1 → child2 → ... → parent
-   - **Ctrl+Left** (or your configured `session_child_cycle_reverse` keybind) to cycle backward through parent ← child1 ← child2 ← ... ← parent
+   - **<Leader>+Right** (or your configured `session_child_cycle` keybind) to cycle forward through parent → child1 → child2 → ... → parent
+   - **<Leader>+Left** (or your configured `session_child_cycle_reverse` keybind) to cycle backward through parent ← child1 ← child2 ← ... ← parent
 
    This allows you to seamlessly switch between the main conversation and specialized subagent work.
 
diff --git a/packages/web/src/content/docs/keybinds.mdx b/packages/web/src/content/docs/keybinds.mdx
index ecac695b3..afcff3a0e 100644
--- a/packages/web/src/content/docs/keybinds.mdx
+++ b/packages/web/src/content/docs/keybinds.mdx
@@ -23,8 +23,8 @@ OpenCode has a list of keybinds that you can customize through the OpenCode conf
     "session_unshare": "none",
     "session_interrupt": "escape",
     "session_compact": "<leader>c",
-    "session_child_cycle": "ctrl+right",
-    "session_child_cycle_reverse": "ctrl+left",
+    "session_child_cycle": "<leader>+right",
+    "session_child_cycle_reverse": "<leader>+left",
     "messages_page_up": "pageup",
     "messages_page_down": "pagedown",
     "messages_half_page_up": "ctrl+alt+u",