feat: Add /subagents command to view subagent tree #3935

Open
opened 2026-02-16 17:42:00 -05:00 by yindo · 1 comment
Owner

Originally created by @adam2am on GitHub (Dec 28, 2025).

Originally assigned to: @rekram1-node on GitHub.

Problem

There's no way to see the full subagent hierarchy in one place.

Current Navigation Options

  1. <leader>+←/→ — Cycles through subagents one-by-one

    • Gets clunky fast with many subagents
    • No overview, just sequential stepping
  2. <leader>+↑ — Goes back to root session

    • Only option to "escape" the subagent tree
    • Can't jump to siblings or specific children
  3. Session list — Shows main sessions only (subagents are filtered out)

    • By design, to avoid clutter
    • But leaves no dedicated place to manage subagents

When This Hurts Most

  • Async multi-agent workflows (e.g., oh-my-opencode spawning parallel agents)
  • Cleaning up leftovers — need to find and delete stale subagents
  • Checking specific subagent details — cycling through 10+ agents to find one

Proposed Solution

Add /subagents command showing:

  • Full tree structure from root
  • Status indicators (idle/busy/retry)
  • Direct navigation (click to switch)
  • Delete (ctrl+d) and rename (ctrl+r) matching session list UX

This keeps the main session list clean while giving subagents a dedicated home.

Implementation

PR: https://github.com/sst/opencode/pull/6289

Originally created by @adam2am on GitHub (Dec 28, 2025). Originally assigned to: @rekram1-node on GitHub. ## Problem There's no way to see the full subagent hierarchy **in one place**. ### Current Navigation Options 1. **`<leader>+←/→`** — Cycles through subagents one-by-one - Gets clunky fast with many subagents - No overview, just sequential stepping 2. **`<leader>+↑`** — Goes back to root session - Only option to "escape" the subagent tree - Can't jump to siblings or specific children 3. **Session list** — Shows main sessions only (subagents are filtered out) - By design, to avoid clutter - But leaves no dedicated place to manage subagents ### When This Hurts Most - **Async multi-agent workflows** (e.g., oh-my-opencode spawning parallel agents) - **Cleaning up leftovers** — need to find and delete stale subagents - **Checking specific subagent details** — cycling through 10+ agents to find one ## Proposed Solution Add `/subagents` command showing: - Full tree structure from root - Status indicators (idle/busy/retry) - Direct navigation (click to switch) - Delete (`ctrl+d`) and rename (`ctrl+r`) matching session list UX This keeps the main session list clean while giving subagents a dedicated home. ## Implementation PR: https://github.com/sst/opencode/pull/6289
yindo added the opentui label 2026-02-16 17:42:00 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Dec 28, 2025):

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

  • #6183: Add interactive session switcher for navigating between subagent sessions

Both issues propose showing the full subagent hierarchy in one place with status indicators, direct navigation, and the ability to delete/rename sessions. #6183 suggests using a keybind-triggered dialog, while this issue proposes a /subagents command. These could potentially be consolidated into a single feature that supports both access methods.

@github-actions[bot] commented on GitHub (Dec 28, 2025): This issue might be a duplicate of existing issues. Please check: - #6183: Add interactive session switcher for navigating between subagent sessions Both issues propose showing the full subagent hierarchy in one place with status indicators, direct navigation, and the ability to delete/rename sessions. #6183 suggests using a keybind-triggered dialog, while this issue proposes a `/subagents` command. These could potentially be consolidated into a single feature that supports both access methods.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3935