pi-xfer — how a handoff travels

Peer transport by default; web picker and mesh are opt-in layers on top

pi-xfer — how a handoff travels Peer transport by default; web picker and mesh are opt-in layers on top Browser + userscript · web picker · picks + records · Machine 1 — local transport (default) Browser + userscript web picker · picks + records Broker daemon · /xfer broker start · Machine 1 — local transport (default) · localhost :4719 Broker daemon /xfer broker start localhost :4719 pi session “alpha” · xfer listener · /xfer name · Machine 1 — local transport (default) pi session “alpha” xfer listener · /xfer name Peer socket · ~/.pi/xfer/<name>.sock · Machine 1 — local transport (default) Peer socket ~/.pi/xfer/<name>.sock pi session “beta” · receives the handoff · Machine 1 — local transport (default) pi session “beta” receives the handoff Engine / control plane · RivetKit · discovery · durable queue · Architecture component Engine / control plane RivetKit · discovery · durable queue Node — machine 2 · joined via /xfer mesh up · Machine 2 Node — machine 2 joined via /xfer mesh up picks · records submit write handoff deliver join: /xfer mesh up handoff Machine 1 — local transport (default) Machine 2 Legend Backend Database Cloud External