Dispatch
Menu
How it worksIdeasArchitectureDocs Principles
GitHub ↗

Documentation

Run a shared workspace on your own machine.

Dispatch runs locally, keeps agent processes alive in tmux, and uses the tools already present in a repository. It gives people and agents a durable place to return to the same terminals, worktrees, and shared context. Installation retrieves a released Bun binary; a production host does not need Node or pnpm to run Dispatch.

Install

Start PostgreSQL 14+ first, then install the latest stable release with one command:

curl -fsSL https://raw.githubusercontent.com/selfcontained/dispatch/main/bin/install-dispatch.sh | bash

The installer works on macOS and Linux. It downloads a tagged release artifact, creates local database credentials when it can administer PostgreSQL, writes private configuration, and registers a user service. It does not clone the repository or require Node, pnpm, Bun, or a hand-written env file.

For a managed database, append -- --database-url 'postgres://…' to the command. Existing installations are moved to this layout by the assisted-update migration; the fresh installer intentionally refuses to overwrite them.

Dispatch runs the platform-matching Bun binary inside dispatch-release.tar.gz. The service manager always invokes one fixed executable path; normal updates atomically replace that executable and restart the service.

Agent CLI support

Codex and Claude are the recommended paths today. They are the CLIs Dispatch is most often exercised against and the best choice for a first installation.

Cursor and OpenCode are supported as agent types, but they still have integration gaps. They can be useful when they match an existing setup; expect the experience to be less complete than Codex or Claude. A plain terminal is also available when the work does not need a coding-agent CLI.

Three concepts to begin with

01

Durable sessions

Agents run in tmux so their work can survive a browser tab, a network interruption, or the time between two decisions.

02

Isolated changes

Worktrees let an agent investigate or implement a change without borrowing the working directory another person is using.

03

Shared context

Messages, pins, media, reviews, and agent events preserve the information that should outlast a terminal transcript.

For implementation details, read the architecture overview and the repository’s README ↗.