Skip to content
    ↑↓ select↵ openesc close
    English中文
    caoool

    Subagents Sidebar

    v0.1.6Agent Orchestration
    opencode-subagents-sidebar-plugin

    OpenCode TUI sidebar footer for active subagents.

    Actively maintained
    #opencode#opencode-plugin#tui#subagents
    GitHub reponpm pageHomepage
    GitHub stars

    0

    Monthly installs

    126

    20 in 7 days

    Composite scoreSCORE

    31.2

    Multi-signal model

    Last commit

    1 month ago

    2026-07-14

    Install and configure

    opencode.json

    Writes to this project's opencode.json — applies to this repository only.

    opencode.json

    {
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-subagents-sidebar-plugin@0.1.6"]
}

    opencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.

    README.md
    View original→

    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.