Repository navigation
OpenCode Subagents Sidebar v0.1.0
OpenCode Subagents Sidebar v0.1.0
The first public release: a live subagent monitor for the OpenCode terminal UI.
Highlights
- Collapsible Subagents section with MCP-sized ▶ / ▼ controls; collapsed by default.
- Live total and running counts, including while collapsed.
- Direct and nested subagents from the current root session, with active tasks first.
- Click a task to open its session while retaining the same family view.
- Explicit
Running,Done,Error,Interrupted,IdleandUnknownstatuses. - Event-driven updates, paginated history recovery, loading/error states and retry.
- Uses the current OpenCode theme; no telemetry, transcript reads or session writes.
Demo — recorded in Warp
Time-compressed capture of a real session, cropped to the sidebar.
Installation
- Download
opencode-plugin-subagents-sidebar-0.1.0.tgzbelow and extract it into a permanent directory. - Add the absolute path of the extracted
packagedirectory to thepluginsarray in~/.config/opencode/cli.json(or$XDG_CONFIG_HOME/opencode/cli.json). Preserve existing entries. - OpenCode reloads the configuration automatically; use
/reloadif needed. Open a session and expand Subagents.
{
"$schema": "https://opencode.ai/v2/cli.json",
"plugins": ["/absolute/path/to/extracted/package"],
"session": { "sidebar": "auto" }
}OpenCode supplies the runtime; no separate dependency installation is needed for the release archive. This is a TUI plugin: configure it in cli.json, not opencode.json.
GitHub-only release. The npm package has not been published.
Compatibility and verification
- Targets OpenCode V2 2.2.5; OpenTUI 0.8.0 / Solid 1.9.17.
- 29 tests, strict TypeScript, lint, formatting and exact archive-content checks.
- CI on Linux and macOS; real OpenCode host smoke testing and Warp capture on macOS.
- Windows has not been verified.
- See the compatibility record for test scope and limitations.
SHA256SUMS covers the attached plugin archive. The GitHub-generated source archives contain the complete repository, including development files.
MIT licensed. Report a bug.
