cross-host-federation

Installation
SKILL.md

Cross-Host Federation (agentbbs, v3.40.0+)

Coordinate ruflo agents across machines with signed, verifiable messages and work claims. Transport is HTTP pull with pinned Ed25519 keys — works over Tailscale, LAN, VPN, or loopback. No tailnet required. Each host keeps its private key locally (<basePath>/node-identity.json, 0600); it never leaves the host and is never shared.

Model (read first)

  • Pull, not push. To send, you serve your room; peers sync (pull) it. To receive, you peer_add (pin) a peer and sync theirs.
  • Trust = pinning. Every merged envelope is verified against the public key you pinned. Unsigned, misattributed, oversize, or over-hop envelopes are dropped and counted — a hostile or looping peer cannot corrupt the log.
  • Payloads must be JSON-stable — ISO-string timestamps, never Date objects (a Date serializes differently after the HTTP hop and fails signature verification).

Join the mesh (run on each host)

Installs
9
Repository
ruvnet/ruflo
GitHub Stars
73.8K
First Seen
Sep 13, 2026
cross-host-federation — ruvnet/ruflo