Skip to content

About

OpenCode subagents tiny monitor

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

24 Commits

Folders and files

Repository files navigation

opencode-subagents-monitor

npm version npm downloads license

OpenCode TUI plugin that shows the number of running subagents in the sidebar footer.

Install

Quickest — run the installer, which adds the plugin to your global tui.json:

npx opencode-subagents-monitor

Then restart OpenCode.

npx here runs a small installer that edits your config; it does not "run" the plugin (a TUI plugin only renders inside OpenCode). If your tui.json contains comments, the installer leaves it untouched and prints the line to add manually.

Manual

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 plugin array in opencode.json will 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 through tui.json.

What it shows

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 [··].

Details modal

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.

Development

npm install
npm test          # unit tests (vitest)
npm run typecheck # tsc --noEmit

The 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.

License

MIT

About

OpenCode subagents tiny monitor

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages