Skip to content

OpenCode Subagents Sidebar v0.1.0

Choose a tag to compare

@andy-takker andy-takker released this 31 Oct 11:28
· 16 commits to main since this release

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, Idle and Unknown statuses.
  • 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

Live subagent counts and expanded task list in Warp

Time-compressed capture of a real session, cropped to the sidebar.

Installation

  1. Download opencode-plugin-subagents-sidebar-0.1.0.tgz below and extract it into a permanent directory.
  2. Add the absolute path of the extracted package directory to the plugins array in ~/.config/opencode/cli.json (or $XDG_CONFIG_HOME/opencode/cli.json). Preserve existing entries.
  3. OpenCode reloads the configuration automatically; use /reload if 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.