docs: clarify subagent session navigation keybinds (#16455)

This commit is contained in:
Wang Siyuan 2026-03-12 22:45:46 +08:00 committed by GitHub
parent 12efbbfa4c
commit a4f8d66a9b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 12 additions and 7 deletions

View File

@ -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:
- **\<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
3. **Navigation between sessions**: When subagents create child sessions, use `session_child_first` (default: **\<Leader>+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.
---

View File

@ -29,9 +29,9 @@ OpenCode has a list of keybinds that you can customize through `tui.json`.
"session_interrupt": "escape",
"session_compact": "<leader>c",
"session_child_first": "<leader>down",
"session_child_cycle": "<leader>right",
"session_child_cycle_reverse": "<leader>left",
"session_parent": "<leader>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` = `\<leader>down`, `session_child_cycle` = `right`, `session_child_cycle_reverse` = `left`, and `session_parent` = `up`.
---
## Disable keybind