Turning raw OpenCode terminal logs into cozy 2D pixel office chaos. Watch your agents work, idle, and celebrate success in a bustling virtual office.
- Real-time Visualization: Watch your OpenCode agents move around their office as they execute tools, search files, and write code.
- Cozy Pixel Art Aesthetic: A calming, gamified view of complex AI orchestration.
- Multi-Agent Support: Visualizes multiple agents (Explore, Scout, etc.) simultaneously in the same shared office space.
- Customization (Skins): Each agent has a custom skin saved in
.opencode/viz-skin.json. - Unique Agent Animations: Each of the 5 characters has its own set of unique idle, walk, work, and reaction animations.
- Zero Friction Launch: No dependencies to install — runs on the Bun runtime bundled with OpenCode. Launches a cross-platform, isolated Chrome "app" window using native OS calls. No heavy Electron needed.
No prerequisites — OpenCode ships with the Bun runtime, which handles plugin installation and execution automatically. You do not need to install Bun separately.
opencode plugin psinetron-opencode-visualizerThis installs the plugin from npm and registers it in your project's opencode.json. Add --global (or -g) to install it across all projects, or --force (or -f) to replace an existing version.
- Press
Control+P(Ctrl+Pon Windows/Linux) to open the command palette - Select Install plugin
- Enter the package name:
psinetron-opencode-visualizer
OpenCode will install the plugin and automatically add it to your project's opencode.json.
Add the plugin name to your opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["psinetron-opencode-visualizer"]
}OpenCode downloads and caches the package from npm automatically on next startup.
If you've cloned this repo and want to run from source, point the plugin entry directly at index.ts:
{
"plugin": ["./path/to/OpenCodeVisualizer/index.ts"]
}Alternatively, copy index.ts and the visualizer/ folder into .opencode/plugins/ — OpenCode auto-loads any .ts/.js file placed in that directory.
Start (or restart) OpenCode. The plugin spins up a local server on http://localhost:5173 and opens a Chrome app window automatically. If the browser doesn't open, visit the URL manually.
Each running OpenCode instance appears as a pixel-art character in the office. When you close an instance, its character walks out. If the instance hosting the server is closed, a surviving instance picks up the server role automatically — no interruption.
To update to the latest version, first try reinstalling with the --force flag:
opencode plugin psinetron-opencode-visualizer --forceIf the old version still persists after that, OpenCode's package cache is stale. Clear it manually and restart:
rm -rf ~/.cache/opencode/packages/psinetron-opencode-visualizer
rm -rf ~/.cache/opencode/packages/psinetron-opencode-visualizer@latestOn Windows (PowerShell):
Remove-Item -Recurse -Force ~\.cache\opencode\packages\psinetron-opencode-visualizer
Remove-Item -Recurse -Force ~\.cache\opencode\packages\psinetron-opencode-visualizer@latestThen restart OpenCode — it will re-download the latest version from npm on startup.
The plugin automatically assigns a random pixel art skin to each agent and saves it to .opencode/viz-skin.json in your project folder. You can manually edit this file to change skins.
Available skins: person1, person2, person3, person4, person5.
This plugin is built on top of OpenCode — an open-source AI coding tool. If you find it useful, consider supporting the project by subscribing to OpenCode GO. Using the link below gives you 50% off and helps fund continued development:
MIT License. See LICENSE for more information. Built, not bought, by psinetron.