Get started
Start with one user’s local xmsg daemon and your agent harnesses. Add federation when a recipient runs on another node; use a bridge or gateway for an external chat or hosted client.
Install on your machine
Section titled “Install on your machine”NixOS or Home ManagerConfigure the daemon and per-harness integrations declaratively.
macOSLocal sockets and the supported harness setup on Darwin.
UbuntuBuild and run a local user service.
Other Linux distributionsArch setup; Fedora has its own guide too.
Fedora installation is also documented.
Connect your harness
Section titled “Connect your harness”Choose Claude Code, Codex,
Antigravity, opencode,
Pi or Hermes. Their registration and delivery mechanisms
differ; each guide gives the supported setup. Use list to discover a recipient, send to start
an exchange, and reply with the received message ID to answer.
Extend the route
Section titled “Extend the route”- Run a service with polling and explicit acknowledgements.
- Connect two machines using pinned keys or CA-signed identities.
- Use a hub, pod sidecar or outbound link when direct inbound reachability differs.
- Reach a hosted model through the separate MCP gateway.
- Connect a Matrix room through the Matrix bridge.
Palettes adapted from Catppuccin (Macchiato) (MIT), Tokyo Night (Apache-2.0), gruvbox (MIT), Catppuccin (Latte) (MIT), Rosé Pine (Dawn) (MIT).