Real-time web dashboard for monitoring OpenCode agent activity — built for use with oh-my-opencode.
bunx ocwatchOr install globally:
bun install -g ocwatch
ocwatchOpens a dashboard at http://localhost:50234 showing live agent sessions, tool calls, and plan progress.
| Flag | Description |
|---|---|
--port <number> |
Server port (default: 50234) |
--host <address> |
Bind address (default: localhost, use 0.0.0.0 for all interfaces) |
--no-browser |
Don't auto-open browser |
--project <path> |
Set project directory for plan tracking |
--help |
Show help |
- Sessions — active and recent agent sessions
- Diagram view — stable parent/child activity tree with focus controls and agent inspector
- Tool calls — live tool invocations with metadata (LSP, AST, MCPs)
- Plan progress — task completion from
.sisyphus/boulder.json - Activity stream — real-time feed of agent actions
- Backend: Bun + Hono — REST API, static file serving,
fs.watchon OpenCode storage directories - Frontend: React 19 + Vite + Tailwind CSS — single dark-theme SPA
- Graph visualization: XY Flow for the agent activity tree
- Data flow: file watcher → cache invalidation → ETag polling + SSE → client
- Monorepo layout:
src/server/,src/client/,src/shared/with@server//@client//@shared/path aliases
Setup
git clone https://github.com/tomascoox/ocwatch.git
cd ocwatch
bun install
cd src/client && bun install && cd ../..Run
bun run dev # Server + Vite concurrently
bun run dev:server # Server only (port 50234)
bun run dev:client # Vite only (port 5173, proxies /api → server)Test
bun run test # Server/shared tests
cd src/client && bun run test # Client unit tests (Vitest)
cd src/client && bun run test:e2e # E2E tests (Playwright)Type check & lint
bun run tsc -b
cd src/client && bun run lintSee CONTRIBUTING.md.
This project is not built by the OpenCode team and is not affiliated with or endorsed by OpenCode or oh-my-opencode.
MIT