npm.io
1.0.6 • Published 3d ago

psinetron-opencode-visualizer

Licence
MIT
Version
1.0.6
Deps
1
Size
1.1 MB
Vulns
0
Weekly
0

psinetron-opencode-visualizer

MIT License GitHub stars NPM Version

Turning raw OpenCode terminal logs into cozy 2D pixel office chaos. Watch your agents work, idle, and celebrate success in a bustling virtual office.


Witness the Chaos

OpenCode Visualizer

Features

  • 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.
  • Mult-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: Pure Bun & TypeScript. Launches a cross-platform, isolated Chrome "app" window using native OS calls. No heavy Electron needed.

Installation

Note: Requires Bun to be installed.

  1. Press Control+P (Ctrl+P on Windows/Linux) to open the command palette
  2. Select Install plugin
  3. Enter the package name: psinetron-opencode-visualizer

OpenCode will install the plugin and automatically add it to your project's opencode.json.

Manual configuration

Add the plugin to your OpenCode config (opencode.json):

{
  "plugin": ["psinetron-opencode-visualizer"]
}

Or install from a local path:

{
  "plugin": ["./path/to/OpenCodeVisualizer"]
}

Customization (Skins)

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.


Support OpenCode

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:

opencode.ai/go?ref=EZW07YHVTG


License

MIT License. See LICENSE for more information. Built, not bought, by psinetron.

Keywords