opencode-fleetviewLaunch fleetview, the agent roster TUI, from inside opencode with /fleetview
0
140
2 in 7 days
32.4
Multi-signal model
22 days ago
2026-07-29
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-fleetview@0.1.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-fleetview@0.1.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-fleetviewopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
An opencode TUI plugin that adds a /fleetview command.
Run it and opencode hands the terminal over to
fleetview, the roster TUI for
backgrounded agent sessions. Quit fleetview and you land back in opencode where
you left off.
The plugin contains no fleetview logic. It is a launcher, about 70 lines.
Requirements
- opencode >= 1.18
- fleetview on your
PATH(npm i -g fleetview, needs Node >= 24)
If fleetview is not installed, /fleetview shows a toast with the install
command instead of launching anything.
Install
opencode plugin opencode-fleetview
That resolves the package, detects its TUI entrypoint, and adds it to the
plugin array in .opencode/tui.json (or ~/.config/opencode/tui.json with
--global). TUI plugins are configured in tui.json, not opencode.json.
To wire it up by hand:
{
"plugin": ["opencode-fleetview"]
}
Use
Type /fleetview in the opencode prompt, or find "FleetView" in the command
palette (ctrl+p).
How it works
The plugin registers one palette command through the opencode TUI plugin API.
When it runs it looks for a fleetview executable on PATH, calls
api.renderer.suspend() to release the terminal, spawns fleetview with
inherited stdio, and calls api.renderer.resume() once fleetview exits.
Development
npm test
To load a local checkout:
opencode plugin /path/to/opencode-fleetview
License
ISC