opencode-multisession

Multi-session orchestrator TUI plugin for OpenCode — manage multiple agent sessions from a single panel.

Features

• Create and manage multiple agent sessions simultaneously
• Sessions organized by status: THINKING (busy), WAITING (permission needed), IDLE (done)
• Animated spinner for active sessions
• Permission info displayed inline for waiting sessions
• Navigate into any session with Enter, back with left arrow
• Delete sessions from tracking with x
• Keyboard-driven: j/k navigation, Tab to switch focus, Esc to go back

Install

One-liner:

curl -fsSL https://raw.githubusercontent.com/OdairFTeixeira/opencode-multisession/main/install.sh | sh

Or manually — add to ~/.config/opencode/tui.json or ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-multisession"]
}

OpenCode installs it automatically with Bun on next startup. Use --project flag for a project-local install.

Usage

1. Run /orchestrator to open the panel
2. Type a prompt and press Enter to start a new agent session
3. Use j/k or arrow keys to navigate the session list
4. Press Enter, l, or right to open a session
5. Press left to return to the orchestrator from inside a session
6. Press x twice to remove a session from tracking
7. Press r to manually refresh
8. Press Tab to switch between the session list and the input box
9. Press Esc to go back (list → input → home)

Keybinds

| Key | Context | Action | |-----|---------|--------| | j / down | List | Move down | | k / up | List | Move up | | Enter / l / right | List | Open session | | x (twice) | List | Remove session from tracking | | r | List | Refresh | | Tab | Any | Switch focus between list and input | | Esc | List | Focus input | | Esc | Input | Go to home | | left | Session view | Back to orchestrator |

License

MIT — GitHub