Introduction

Ocman is a web dashboard for browsing and driving your coding-agent sessions. It reads OpenCode ’s session database read-only and talks to running OpenCode instances over their HTTP API, so it never owns your data and never gets in the way of the CLI.

One binary, no runtime dependencies (pure-Go SQLite), listening on 127.0.0.1:8228 by default.

Install

# Download a binary from the releases page, then:
./ocman
# Open http://localhost:8228

Prebuilt binaries — including a macOS .dmg desktop build — are on the releases page . To build from source you need Go 1.24+ and Node.js 22+:

make build && ./ocman

Your first session

Existing sessions show up immediately — grouped by project, searchable, replayable. To get an interactive session (composer, permission replies, abort), let ocman launch it:

1. Press ⌘K to open the command palette.
2. Run /wt to create a git worktree session, or use the project’s Worktrees view.

Ocman keeps one managed OpenCode instance per project and connects to it automatically, so parallel worktree sessions get isolated files and staging areas without a process per worktree.

If you prefer to run OpenCode yourself, start it with an explicit port so ocman can discover it:

opencode --port 0   # let OpenCode pick a free port

Without --port, externally launched sessions stay readable but the composer is disabled.

Where to next