Skip to content

docs: clarify subagent session navigation keybinds#16455

Merged
rekram1-node merged 5 commits intoanomalyco:devfrom
Wangmerlyn:docs-subagent-keybind-clarity
Mar 12, 2026
Merged

docs: clarify subagent session navigation keybinds#16455
rekram1-node merged 5 commits intoanomalyco:devfrom
Wangmerlyn:docs-subagent-keybind-clarity

Conversation

@Wangmerlyn
Copy link
Copy Markdown
Contributor

@Wangmerlyn Wangmerlyn commented Mar 7, 2026

Issue for this PR

Closes #16462

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

This docs-only PR fixes the documentation mismatch described in #16462, where subagent session navigation keybinds documentation does not match the actual implementation behavior.

What changed:

  • Updated packages/web/src/content/docs/agents.mdx to describe the actual hierarchical flow: use session_child_first to enter a child, then use bare arrow keys inside child sessions.
  • Updated packages/web/src/content/docs/keybinds.mdx keybind example to include session_child_first and the actual defaults (right/left/up without leader key).
  • Added a short note explaining that some navigation keybinds intentionally do not use the leader key by default.

Why this is needed:

How did you verify your code works?

  • Built docs package successfully with bun run build in packages/web.
  • Cross-checked docs wording against current keybind defaults in packages/opencode/src/config/config.ts and session command enablement in packages/opencode/src/cli/cmd/tui/routes/session/index.tsx.

Screenshots / recordings

N/A (documentation-only change)

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@Wangmerlyn Wangmerlyn marked this pull request as ready for review March 7, 2026 10:18
@Wangmerlyn
Copy link
Copy Markdown
Contributor Author

Related user report: #10444

The user tried to use ctrl+x right/left for session_child_cycle but it didn't work - this is exactly the confusion this PR addresses. The docs showed <leader>right/left but the actual behavior requires entering the child session first with <leader>down, then using bare right/left to cycle.

This PR clarifies the hierarchical navigation flow in the documentation.

@Wangmerlyn Wangmerlyn force-pushed the docs-subagent-keybind-clarity branch from 108663a to 30566aa Compare March 9, 2026 08:17
@rekram1-node rekram1-node changed the title docs(web): clarify subagent session navigation keybinds docs: clarify subagent session navigation keybinds Mar 12, 2026
@rekram1-node rekram1-node merged commit a4f8d66 into anomalyco:dev Mar 12, 2026
8 checks passed
Spin-Particle pushed a commit to Science-Discovery/Aether that referenced this pull request Mar 12, 2026
ChicK00o pushed a commit to ChicK00o/opencode that referenced this pull request Mar 12, 2026
demostanis pushed a commit to demostanis/opencode that referenced this pull request Mar 19, 2026
demostanis pushed a commit to demostanis/opencode that referenced this pull request Mar 20, 2026
balcsida pushed a commit to balcsida/opencode that referenced this pull request Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: session navigation keybind documentation mismatch with actual behavior

2 participants