Repository navigation
v0.2.0 — Task trees, attention states and keyboard navigation
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:
/subagentsand 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
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.
