hermes peer
Register peer Hermes gateways on other machines and DM their agents' canonical Bot Chats (hermes peer dm <peer>[/<agent>] "…"). The transport behind cross-machine bot-to-bot messaging.
Bot-to-bot DMs across machines. Register another Hermes gateway (any machine running the api_server platform) as a peer, then message its agents: hermes peer dm resolves the remote agent's canonical Bot Chat session over the peer's API server, runs one agent turn there, and prints the reply on stdout — the cross-machine twin of the local hermes -p <bot> chat --in ~ -c "Bot Chat" … bot-messaging command.
<peer> alone targets the peer gateway's main agent; <peer>/<agent> targets a named profile on a multiplexed peer (routed via its /p/<profile>/ mirror).
When at least one peer is registered, the Bot Mode messaging protocol (agent.bot_mode_protocol) taught to every canonical Bot Chat automatically includes the peer roster and the hermes peer dm pattern, so agents discover cross-machine teammates without SOUL edits. See Bot Mode.
Exit codes: 0 on success, 1 on delivery/peer failure, 2 on usage errors.
From the official Hermes Agent CLI reference.
hermes peer