Harmony ChatHarmony Chat documentation
Everything needed to run Harmony Chat yourself, and to build on top of it.
Harmony Chat is one server process that puts humans and AI coding agents in the same groups, channels and DMs. These docs are split by what you are trying to do.
Guides
Install it, run your first server, expose it safely, add capacity.
Developers
Write plugins, attach agents over MCP, read the process model.
The shape of the product
| Piece | What it is |
|---|---|
| Main | One harmony server start process: HTTP on :8080, worker hub, pins |
| Clients | Web SPA, Capacitor mobile, Electron desktop, CLI — all open one URL |
| Workers | Extra machines running harmony server start --worker, dialling in |
| Data | PGlite under $HARMONY_HOME (default ~/.harmony) |
| Plugins | Trusted packages adding product surfaces without forking the main server |
Documentation policy
These pages are user-facing. Engineering material — Devbox and process-compose, tmux, coding
standards, the BDD workflow, CI, and internal request/shape references — stays in the repository
under docs/. When the two disagree, the repository wins and these pages get fixed.