Skip to content

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
· 3 commits to main since this release
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.