From a4f8d66a9bd8053ae797d129c139363b4fdd1707 Mon Sep 17 00:00:00 2001 From: Wang Siyuan Date: Thu, 12 Mar 2026 22:45:46 +0800 Subject: [PATCH] docs: clarify subagent session navigation keybinds (#16455) --- packages/web/src/content/docs/agents.mdx | 11 +++++++---- packages/web/src/content/docs/keybinds.mdx | 8 +++++--- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/packages/web/src/content/docs/agents.mdx b/packages/web/src/content/docs/agents.mdx index 53de8af5f..876464212 100644 --- a/packages/web/src/content/docs/agents.mdx +++ b/packages/web/src/content/docs/agents.mdx @@ -120,11 +120,14 @@ Hidden system agent that creates session summaries. It runs automatically and is @general help me search for this function ``` -3. **Navigation between sessions**: When subagents create their own child sessions, you can navigate between the parent session and all child sessions using: - - **\+Right** (or your configured `session_child_cycle` keybind) to cycle forward through parent → child1 → child2 → ... → parent - - **\+Left** (or your configured `session_child_cycle_reverse` keybind) to cycle backward through parent ← child1 ← child2 ← ... ← parent +3. **Navigation between sessions**: When subagents create child sessions, use `session_child_first` (default: **\+Down**) to enter the first child session from the parent. - This allows you to seamlessly switch between the main conversation and specialized subagent work. +4. Once you are in a child session, use: + - `session_child_cycle` (default: **Right**) to cycle to the next child session + - `session_child_cycle_reverse` (default: **Left**) to cycle to the previous child session + - `session_parent` (default: **Up**) to return to the parent session + + This lets you 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 54c15e862..74ef30577 100644 --- a/packages/web/src/content/docs/keybinds.mdx +++ b/packages/web/src/content/docs/keybinds.mdx @@ -29,9 +29,9 @@ OpenCode has a list of keybinds that you can customize through `tui.json`. "session_interrupt": "escape", "session_compact": "c", "session_child_first": "down", - "session_child_cycle": "right", - "session_child_cycle_reverse": "left", - "session_parent": "up", + "session_child_cycle": "right", + "session_child_cycle_reverse": "left", + "session_parent": "up", "messages_page_up": "pageup,ctrl+alt+b", "messages_page_down": "pagedown,ctrl+alt+f", "messages_line_up": "ctrl+alt+y", @@ -114,6 +114,8 @@ By default, `ctrl+x` is the leader key and most actions require you to first pre You don't need to use a leader key for your keybinds but we recommend doing so. +Some navigation keybinds intentionally do not use the leader key by default. For subagent sessions, the defaults are `session_child_first` = `\down`, `session_child_cycle` = `right`, `session_child_cycle_reverse` = `left`, and `session_parent` = `up`. + --- ## Disable keybind