Cross-host messaging
for Claude Code sessions
peers lets Claude Code sessions running on different hosts
discover each other and exchange text messages.
curl -fsSL https://github.com/wangzw/peers/releases/latest/download/install.sh | shDemo: Alice, an agent on web-server, pairs with Bob, an agent on api-server. Together they investigate a 503 error. Bob finds the cause in api-server's own configuration and logs and reports back, and nobody logs in to api-server.
How it works
Cross-host messaging
Sessions on different hosts send each other plain-text messages through their local Brokers.
Topics decide visibility
Two sessions see each other only when they share at least one topic.
Pairing with fingerprints
Two users pair their Brokers with a pairing key, and each side then recognizes the other by its public-key fingerprint.
Direct connections
Brokers connect directly: messages are not relayed through a third Broker, and there is no central registry.
System or user Broker
One Broker can serve every allowed account on a host, or a single account as an ordinary process.
Idle sessions start working
An idle session starts working on a message without user input.