OpenCode TUI plugin that shows the number of running subagents in the sidebar footer.
Quickest — run the installer, which adds the plugin to your global tui.json:
npx opencode-subagents-monitorThen restart OpenCode.
npxhere runs a small installer that edits your config; it does not "run" the plugin (a TUI plugin only renders inside OpenCode). If yourtui.jsoncontains comments, the installer leaves it untouched and prints the line to add manually.
This is a TUI plugin, so it goes in tui.json (not opencode.json).
Add to your project tui.json, or your global ~/.config/opencode/tui.json to enable it everywhere:
{
"$schema": "https://opencode.ai/tui.json",
"plugin": ["opencode-subagents-monitor"]
}Restart OpenCode after editing the file.
Installing via the
pluginarray inopencode.jsonwill fail to load — that list is for server plugins, which loads the bundled entry and cannot resolve the TUI JSX runtime. TUI plugins must be registered throughtui.json.
The plugin replaces the sidebar footer, appending a running-subagent count on the right of the • OpenCode {version} line:
~/projects/my-project:main
• OpenCode 1.16.2 3 [••]
The number counts active subagents, covering both direct child sessions and background-mode tasks (task tool with background: true). With none running it shows [··].
Click the [••] indicator while agents are running to open a modal showing:
- Agent type (explore, librarian, oracle, etc.)
- Task description
- Live runtime counter
The modal auto-closes when all agents finish. Press Esc to dismiss manually.
npm install
npm test # unit tests (vitest)
npm run typecheck # tsc --noEmitThe plugin ships as raw TypeScript source — OpenCode loads src/index.tsx
directly via the ./tui export and applies the SolidJS/JSX transform at
load time. There is no build step.
MIT