vibepulse
v0.2.1
Published
Real-time dashboard for monitoring and managing OpenCode sessions
Readme
VibePulse
A tiny dashboard that sits in your browser tab — tired of switching IDE tabs just to check which OpenCode sessions finished.

What It Does
- Kanban board — Auto-discovers OpenCode sessions, organizes them into Idle / Busy / Review / Done
- Remote Nodes — Connect multiple VibePulse instances to a single hub for a unified view
- Audio alerts — Makes a sound when sessions complete or need attention
- Zero setup — No manual card creation; auto-scans ports and processes
- Profile switcher — Flip between OMO presets without touching config files
Quick Start
Hub Mode (Default)
Run VibePulse locally to monitor your local OpenCode sessions and manage remote nodes.
npx vibepulseOpen http://localhost:3456
Node Mode
Run VibePulse on a remote server to expose its OpenCode sessions to a hub.
npx vibepulse --serveNode mode requires an access token for security. See Architecture for details.
Features
| Feature | Description | |---------|-------------| | Hub & Node | Distributed architecture for monitoring multiple remote hosts | | Real-time sync | SSE + polling for live session updates | | Sticky states | 25s sticky window prevents status flickering | | Offline snapshot | Shows last known state when a node is unreachable | | IDE integration | Click to open workspace in VSCode / Antigravity | | Config UI | Manage agent models and remote nodes through the interface |
Architecture
VibePulse uses a Hub-and-Node architecture to aggregate OpenCode sessions across different machines.
- Node: A VibePulse instance running with
--serve. It interacts directly with the local OpenCode SDK and exposes an API. - Hub: The primary VibePulse instance (default mode). It connects to one or more Nodes to collect session data.
Connecting a Remote Node
- Start the remote node:
VIBEPULSE_NODE_TOKEN=your-secret npx vibepulse --serve - Open your local VibePulse Hub.
- Click the Host Manager icon.
- Click Add Remote Node.
- Enter the Node URL (e.g.,
http://remote-server:3456) and the Access Token.
Development
git clone https://github.com/ChatTreeNet/VibePulse.git
cd VibePulse
npm install
npm run devTech Stack
- Next.js (App Router) + TypeScript
- Tailwind CSS + @dnd-kit
- TanStack Query + @opencode-ai/sdk
License
MIT
