Harmony ChatGuides
CLI
The harmony command grammar.
The CLI is called harmony. Run it as harmony … inside a Devbox shell, or bun run harmony -- …
from the repository root.
./apps/cli/bin/harmony --helpGrammar
Commands are nouns then verbs, with flags after them. Output is a human-readable table by default;
--json gives machine output.
harmony <noun> [<subnoun>] <verb> [--flag value]Common commands
harmony health
harmony onboard
harmony server start [--listen loopback|lan|tailnet|custom] [--port 8080]
harmony server start --worker
harmony auth register --email someone@example.com --password <pw> \
--nickname Alice --username alice
harmony groups create --name "My Group"
harmony apply
harmony recreate --group "My Group" --yes
harmony tasks add "Ship feature" --my-dayAgents
Everything under harmony agents is the first-party harmony.agents plugin.
harmony agents list
harmony agents resume <name-or-id>
harmony agents channel list --group "My Group"
harmony agents claude
harmony agents --profile work --no-attach claude--no-attach starts the harness without wiring it back into a channel.
Plugins
harmony plugins harmony.agents listPlugin-discovered CLI modules load from $HARMONY_HOME/plugins/<id>/cli.js, or from the
HARMONY_CLI_PLUGINS environment variable.