OpenCode SubAgent Magazine plugin
A sidebar for the OpenCode TUI that tracks subagents live: status, tokens, cost and a jump into each subagent session.
- 136 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin reads OpenCode session data and stores it locally.
- It loads as third-party code inside the TUI.
Install
- Works in
Manual install
npm install -g opencode-subagent-magazine@latestOpenCode 1.x: after installing, add the package to `plugin` in `~/.config/opencode/tui.jsonc`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin reads OpenCode session data and stores it locally.
- It loads as third-party code inside the TUI.
This is third-party code. Review the repository files before installing.
What it does
The plugin adds a subagent list to the OpenCode TUI sidebar. Each subagent carries a coloured dot: running, finished or failed. The panel title shows total token use and cost across all subagents of the session. An expanded row lists agent type, elapsed time, tokens, cost, model and session ID, and a button opens the subagent's full conversation. Whether the panel is collapsed or expanded persists across restarts. Settings change through slash commands: language, list order, retention period, refresh mode and time format.
Who it is for. OpenCode users who run several subagents and lose track of which one is stuck and what it costs.
Good fit when
- The main agent hands tasks to subagents and you want to see which are still running.
- A subagent hung and its entry has to be closed by hand with the mark button or `/subagent-clear-running`.
- You want to compare token and cost figures per subagent at the end of a session.
- Several TUI windows are open at once and entries must persist without overwriting.
Not a fit when
- You work in Claude Code or Codex; the plugin is written for OpenCode only.
- You need statistics for cloud or remote sessions; the panel sees subagents of the local TUI.
- You need a cost report for accounting; the figures are an in-session guide.
Example request
Open a session with three subagents and show in the sidebar which are running, which finished and how many tokens each used.Limitations
The plugin supports OpenCode 1.x and 2.x, and the setup differs between them. On 2.x do not install it with `opencode plugin add`: that writes it to the server plugin config and loading fails with an error. If the plugin does not appear, clear the cache: `~/.cache/opencode/npm` for 2.x and `~/.cache/opencode/packages` for 1.x. Subagent data is stored locally and expires after a configurable period. The README is mainly Chinese; switch the panel language with `/subagent-lang`.
How to disable. Remove the plugin entry from `cli.json` (2.x) or `tui.jsonc` (1.x) and restart OpenCode. If installed through npm, run `npm uninstall -g opencode-subagent-magazine`.
FAQ
How do I install the plugin on OpenCode 2.x?
Add an object with the package `opencode-subagent-magazine@latest` to the `plugins` array of `~/.config/opencode/cli.json`. OpenCode installs and loads it on the next start.
How do I install the plugin on OpenCode 1.x?
Run `npm install -g opencode-subagent-magazine@latest` and add the package name to `plugin` in `~/.config/opencode/tui.jsonc`. Alternatively press Ctrl+P, search `install plugin` and enter the package name.
What if a subagent entry is stuck?
Expand the row and press the mark-complete button. The `/subagent-clear-running` command clears all stuck entries at once.
How do I show cost in the list?
The `/subagent-cost` command turns on cost in list rows. The expanded row always shows it.
How do I change the panel language?
Run `/subagent-lang`: it switches between Chinese and English and the choice persists. The README is mainly Chinese.
Discussion
No questions or reviews yet.
Related
PluginsOrchestrator plugin for OpenCode and Codex CLI: multiple agents, hooks, built-in MCPs, ultrawork mode and hash-anchored edits
An open source coding agent for the terminal and desktop with build and plan modes
An OpenCode plugin that runs a team of parallel agents with separate sessions, a shared task board and messaging
A local dashboard for Claude Code: a live graph of sessions and subagents, tokens, cost and file conflicts.
A terminal dashboard for spend, quotas and rate limits across Claude Code, Codex, Cursor, Copilot and other AI tools
A top-style terminal dashboard for Claude Code and Codex sessions: spend, tokens, context load, processes and tool calls.
README in short
The documentation covers the panel features, two install paths for OpenCode versions and the list of `/subagent-*` slash commands. Panel state and settings persist across restarts.