Skip to content

Releases

v0.2.1 — Fix npm plugin loading

Choose a tag to compare

@andy-takker andy-takker released this 31 Oct 21:32
6acc224

npm loading fix

Version 0.2.1 fixes the npm installation failure in 0.2.0 (Cannot find package 'react'). The package now ships a precompiled Solid/OpenTUI entry instead of source TSX, because the host source transform excludes node_modules.

  • The sole export remains ./tui.
  • Solid, OpenTUI and the OpenCode plugin runtime remain external and host-owned.
  • No React dependency or runtime behavior change is introduced.
  • A real packed-package regression test exercises loading, rendering, navigation and cleanup beneath node_modules.

Install

Download and extract opencode-plugin-subagents-sidebar-0.2.1.tgz to a permanent directory, then add its absolute directory path to plugins in ~/.config/opencode/cli.json, preserving existing entries. No separate dependency installation is needed for the extracted archive. Use /reload if necessary.

Published on npm as latest. The pinned entry is:

{
  "plugins": ["opencode-plugin-subagents-sidebar@0.2.1"]
}

The npm archive is byte-identical to the attached checked archive. Loading by the exact npm name above was verified in OpenCode 2.2.5 on macOS arm64, including expansion of the nested task tree and completed statuses/durations. Do not install React as a workaround for 0.2.0.

Verification

  • 127 tests / 398 assertions, strict types, recommended lint, formatting and package checks.
  • Linux and macOS CI.
  • OpenCode 2.2.5 on macOS arm64 loaded the checked archive beneath node_modules, alongside Orca, with running/completed tasks, nested rows, keyboard navigation, reload and root switching.
  • Windows and a Linux host runtime remain unverified.

SHA256SUMS covers the attached archive. See the compatibility record and changelog.

v0.2.0 — Task trees, attention states and keyboard navigation

Choose a tag to compare

@andy-takker andy-takker released this 31 Oct 21:15
16c64de

Update: v0.2.1 fixes the npm loader packaging defect described below. Prefer the newer release.

OpenCode Subagents Sidebar v0.2.0

All six monitoring and navigation improvements in one release:

  • Nested task tree: parent-first groups, │ ├─ └─ connectors, active-subtree priority and bounded indentation.
  • Active / All: live filters with separately counted, muted ancestor context.
  • Attention: confirmed unanswered permissions/forms show Waiting; collapsed summaries distinguish running, waiting and errors.
  • Execution duration: current-execution clocks, frozen completion times, aligned status/time columns and explicit unknown timestamps.
  • Keyboard navigation: /subagents and Open subagent in the command palette; search, arrows, Enter and Escape, even with the sidebar hidden.
  • Scoped synchronization: ignore confirmed unrelated events while preserving complete discovery, reconnect recovery and bounded I/O.

Ordering change

In v0.2.0, rows are grouped parent-before-child rather than globally sorted by activity. Active keeps necessary inactive ancestors, marked · and counted separately. Package exports remain unchanged (./tui only).

Demo

v0.2.0 tree, filters, attention and keyboard search

Captured in Warp using the actual plugin components with explicitly labelled demonstration data. Time-compressed; not a live agent execution or host-compatibility recording.

Install

Download the attached opencode-plugin-subagents-sidebar-0.2.0.tgz, verify it with SHA256SUMS, and extract it to a permanent directory. Append the absolute path of its package directory to the existing plugins array in ~/.config/opencode/cli.json:

{
  "plugins": ["/absolute/path/to/package"]
}

Preserve other entries. OpenCode supplies the shared runtime; the archive needs no separate dependency install. Use /reload if needed.

Known npm loading issue in OpenCode 2.2.5: version 0.2.0 is published on npm, but loading it by package name fails with Cannot find package 'react' while processing its TSX entrypoint from node_modules. Use the extracted archive with an absolute directory path as shown above; that installation was verified in the host. Do not add React as a workaround.

The npm tarball is byte-for-byte identical to the attached checked archive. This first publication was authenticated interactively; automated OIDC publishing remains disabled. A packaging follow-up is needed for installation by npm name.

Verification and compatibility

  • 126 tests / 395 assertions, strict TypeScript, recommended lint and formatting.
  • Linux and macOS CI, exact archive checks and artifact upload/download round trips.
  • OpenCode 2.2.5, OpenTUI 0.8.0, Solid 1.9.17; macOS arm64 packed-plugin smoke verification.
  • Windows and a Linux host runtime remain unverified. Live human permission/form interaction is covered by integration/renderer tests, not claimed as a manual host test.

See the compatibility record and changelog. MIT licensed.

OpenCode Subagents Sidebar v0.1.0

Choose a tag to compare

@andy-takker andy-takker released this 31 Oct 11:28

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.