ctrl+x up keyboard shortcuts do not work #4664

Closed
opened 2026-02-16 17:44:57 -05:00 by yindo · 7 comments
Owner

Originally created by @skerit on GitHub (Jan 10, 2026).

Originally assigned to: @kommander on GitHub.

Description

I clicked a subagent session and was transported into the session.
Very cool.

But now I'm stuck.

I see at the top:

Subagent session Parent ctrl+x up Prev ctrl+x left Next ctrl+x right

None of these ctrl+x+arrow buttons do anything

I'm unable to exit. The only thing I can do is ctrl+c, which immediately exits the entire application.

Plugins

No response

OpenCode version

1.1.12

Steps to reproduce

  1. Use a subagent / task
  2. Click the subagent/task
  3. Get stuck inside the subagent/task

Screenshot and/or share link

No response

Operating System

Linux

Terminal

Wezterm

Originally created by @skerit on GitHub (Jan 10, 2026). Originally assigned to: @kommander on GitHub. ### Description I clicked a subagent session and was transported into the session. Very cool. But now I'm stuck. I see at the top: > **Subagent session** **Parent** _ctrl+x up_ **Prev** _ctrl+x left_ **Next** ctrl+x right None of these ctrl+x+arrow buttons do _anything_ I'm unable to exit. The only thing I can do is ctrl+c, which immediately exits the entire application. ### Plugins _No response_ ### OpenCode version 1.1.12 ### Steps to reproduce 1. Use a subagent / task 2. Click the subagent/task 3. Get stuck inside the subagent/task ### Screenshot and/or share link _No response_ ### Operating System Linux ### Terminal Wezterm
yindo added the opentuibug labels 2026-02-16 17:44:57 -05:00
yindo closed this issue 2026-02-16 17:44:57 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Jan 10, 2026):

This issue might be a duplicate of existing issues. Please check:

  • #5706: ctrl+x left shortcut for switching to sub agent session is not present in ctrl+p commands menu
  • #4180: ctrl-left/right doesn't navigate between subagents since 1.0 TUI - TUI captures left and right?
  • #4292: [feedback] make left / right navigation for subagents more clear
  • #2390: Switching to a child session doesn't send subsequent messages to that session but to the parent one
  • #4422: Primary agent responds in subagent view; delegated subagent views become inaccessible
  • #3291: [FEATURE]: Navigation to parent session from child/subagent sessions
  • #6491: Session does not automatically return to parent after subagent execution

There's also a mention of keybind documentation in #4997 which may have relevant information about the ctrl+x navigation shortcuts.

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Jan 10, 2026): This issue might be a duplicate of existing issues. Please check: - #5706: `ctrl+x left` shortcut for switching to sub agent session is not present in `ctrl+p` commands menu - #4180: `ctrl-left/right doesn't navigate between subagents since 1.0 TUI - TUI captures left and right?` - #4292: `[feedback] make left / right navigation for subagents more clear` - #2390: `Switching to a child session doesn't send subsequent messages to that session but to the parent one` - #4422: `Primary agent responds in subagent view; delegated subagent views become inaccessible` - #3291: `[FEATURE]: Navigation to parent session from child/subagent sessions` - #6491: `Session does not automatically return to parent after subagent execution` There's also a mention of keybind documentation in #4997 which may have relevant information about the ctrl+x navigation shortcuts. Feel free to ignore if none of these address your specific case.
Author
Owner

@skerit commented on GitHub (Jan 10, 2026):

None of these seem to be duplicates of my issue.
The second one #4180 came close, but that was only for ctrl + left/right, and due to a MacOS already having a binding for that.
I do not have a binding on my Linux machine for ctrl + x + up/left/right

@skerit commented on GitHub (Jan 10, 2026): None of these seem to be duplicates of my issue. The second one #4180 came close, but that was only for `ctrl + left/right`, and due to a MacOS already having a binding for that. I do not have a binding on my Linux machine for `ctrl + x + up/left/right`
Author
Owner

@frasza commented on GitHub (Jan 10, 2026):

I was confused about this but I figured you have to press ctrl +x first and THAN up separately.

@frasza commented on GitHub (Jan 10, 2026): I was confused about this but I figured you have to press ctrl +x first and THAN up separately.
Author
Owner

@skerit commented on GitHub (Jan 11, 2026):

Well I'll be damned
Even with the explanation on the keybinds documentation page did I not figure that out:

Leader key

OpenCode uses a leader key for most keybinds. This avoids conflicts in your terminal.

By default, ctrl+x is the leader key and most actions require you to first press the leader key and then the shortcut. For example, to start a new session you first press ctrl+x and then press n.

If it had been worded like "first press the leader key, release, and then the shortcut" I might have figured it out. Or made it more obvious that some kind of special shortcut mode is being enabled.

In the "normal" non-subagent mode I might have figured it out, since I see that when you press ctrl+x there the text input area gets greyed out, but there is no such visual hint in the subagent screen.

@skerit commented on GitHub (Jan 11, 2026): Well I'll be damned Even with the explanation on the keybinds documentation page did I not figure that out: > [Leader key](https://opencode.ai/docs/keybinds/#leader-key) > > OpenCode uses a leader key for most keybinds. This avoids conflicts in your terminal. > > By default, ctrl+x is the leader key and most actions require you to first press the leader key and then the shortcut. For example, to start a new session you first press ctrl+x and then press n. If it had been worded like "first press the leader key, release, and then the shortcut" I might have figured it out. Or made it more obvious that some kind of special shortcut mode is being enabled. In the "normal" non-subagent mode I might have figured it out, since I see that when you press ctrl+x there the text input area gets greyed out, but there is no such visual hint in the subagent screen.
Author
Owner

@mingshi2333 commented on GitHub (Jan 11, 2026):

Yes, similar to Vim shortcuts, you can try to resolve confusion with a simple comment like [ctrl x]

@mingshi2333 commented on GitHub (Jan 11, 2026): Yes, similar to Vim shortcuts, you can try to resolve confusion with a simple comment like `[ctrl x]`
Author
Owner

@ethaizone commented on GitHub (Jan 12, 2026):

I did search and found this issue so I'm not alone.
and my mind become blank when I saw @frasza message. LMAO

@ethaizone commented on GitHub (Jan 12, 2026): I did search and found this issue so I'm not alone. and my mind become blank when I saw @frasza message. LMAO
Author
Owner

@rekram1-node commented on GitHub (Jan 12, 2026):

I made the header things clickable too now, so if u get stuck u can just click "Parent" and itll nav u back

ill look how others do it so we can update docs to be more clear, any recs or prs to fix confusion also welcome

@rekram1-node commented on GitHub (Jan 12, 2026): I made the header things clickable too now, so if u get stuck u can just click "Parent" and itll nav u back ill look how others do it so we can update docs to be more clear, any recs or prs to fix confusion also welcome
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#4664