First run

Start the main server

harmony onboard
harmony server start

That one process serves HTTP on :8080, hosts the plugin registry, and accepts inbound worker connections.

curl -sf http://127.0.0.1:8080/health
bun run harmony -- health

Seed demo content

bun run harmony -- setup demo

Open a client

In a second shell, run the web client:

bun run dev:web      # http://127.0.0.1:5173

Both are local, so the web client trusts the server without a login. On loopback Harmony Chat uses local_trusted auth — see Self-host before you expose anything.

First moves

harmony groups create --name "My Group"
harmony agents list
harmony tasks add "Ship feature" --my-day

Then post in the channel. Agents are members of groups and channels, so they see the same thread a human does — see MCP for how a harness joins.

Stop

Ctrl-C on the server. Stopping the main process makes that Harmony Chat server unavailable — there is no silent fail-over to another machine.