OpenCode Subagents Sidebar

An OpenCode 1.17.15+ TUI-only plugin that adds a Subagents section to the sidebar footer. It shows pending and running task subagents for the current parent session (or when viewing one of its child sessions).

Each subagent uses a spaced two-line card: its role with model and raw effort/reasoning variant, then its assigned task description with a right-aligned elapsed runtime. Model and effort colors match the metadata below OpenCode's prompt. Click anywhere on a card to open a non-modal, live popover attached to that card (left first, then right, with above/below fallbacks on narrow terminals). It shows status, foreground/background mode, child session ID, model details, and the newest live assistant activity—text, reasoning, or tool work—as a single truncated line. The child transcript refreshes while the popover is open even when public TUI state has not populated it yet. Opening another card replaces the popover; clicking outside it, navigating away, opening a host dialog, or using Close dismisses it. Open Session is available once the child session exists (unless it is already open). Completed tasks are hidden unless OpenCode still reports their background child session as active.

Install

opencode plugin opencode-subagents-sidebar-plugin --global

Quit and restart OpenCode after installing; plugins are loaded at startup.

For a manual TUI plugin entry, add this package's TUI export to tui.json. The plugin_enabled entry is optional; include it to use this plugin without OpenCode's built-in sidebar context:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin_enabled": { "internal:sidebar-context": false },
  "plugin": ["opencode-subagents-sidebar-plugin"]
}

Restart OpenCode after changing tui.json.

The source repository is available at https://github.com/caoool/opencode-subagents-sidebar-plugin.

Development

npm install
npm run typecheck
npm run build
npm test
npm run check
npm pack --dry-run

dist/ is committed intentionally: OpenCode installs Git packages with lifecycle scripts disabled.