https://github.com/psinetron/opencode-visualiser
Turning raw AI terminal logs into cozy 2D pixel office chaos. The definitive visualizer for OpenCode agents.
https://github.com/psinetron/opencode-visualiser
ai ai-tools bun opencode typescript
Last synced: 9 days ago
JSON representation
Turning raw AI terminal logs into cozy 2D pixel office chaos. The definitive visualizer for OpenCode agents.
- Host: GitHub
- URL: https://github.com/psinetron/opencode-visualiser
- Owner: psinetron
- License: mit
- Created: 2026-06-01T14:04:56.000Z (19 days ago)
- Default Branch: main
- Last Pushed: 2026-06-04T09:33:04.000Z (16 days ago)
- Last Synced: 2026-06-04T11:10:39.783Z (16 days ago)
- Topics: ai, ai-tools, bun, opencode, typescript
- Language: HTML
- Homepage: https://github.com/psinetron/opencode-visualiser/blob/main/README.md
- Size: 1.59 MB
- Stars: 4
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 👾 psinetron-opencode-visualizer
[](https://github.com/psinetron/opencode-visualiser/blob/main/LICENSE)
[](https://github.com/psinetron/opencode-visualiser/stargazers)
[](https://www.npmjs.com/package/psinetron-opencode-visualizer)
**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
---
## ✨ 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](https://bun.sh) to be installed.*
### Via OpenCode UI (recommended)
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`):
```json
{
"plugin": ["psinetron-opencode-visualizer"]
}
```
Or install from a local path:
```json
{
"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`.
---
## 📜 License
MIT License. See LICENSE for more information. Built, not bought, by psinetron.