https://sonny.sh/docs/mesh/Run Sonny as a distributed session mesh: host sessions on remote nodes, attach to them over gRPC, and move live sessions between machines.Hugo 0.139.4en-usSat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mesh/architecture/Sat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mesh/architecture/mesharchitecturenetworking Mesh Architecture Share link Share this section Permalink Share via Twitter LinkedIn Facebook graph LR C[Client / CLI / Desktop] -->|gRPC :50052| N1[Node A] C -->|gRPC :50052| N2[Node B] N1 <-->|Synapse QUIC :50053| N2 N1 --> DB1[(control.db)] N2 --> DB2[(control.db)] The two planes Share link A node listens on two independent surfaces. Keeping them separate is what lets a mesh upgrade one plane without dropping sessions on the other.https://sonny.sh/docs/mesh/running-the-mesh/Sat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mesh/running-the-mesh/meshoperationsquickstart Running the Mesh Share link Share this section Permalink Share via Twitter LinkedIn Facebook Start a node Share link sonny mesh serve \ --grpc 127.0.0.1:50052 \ --synapse-listen 127.0.0.1:50053 \ --control-db /var/lib/sonny/control.db The node listens for gRPC client connections, advertises on the Synapse QUIC peer plane, sends heartbeats to announce availability, and accepts sessions pushed from other nodes.https://sonny.sh/docs/mesh/sessions/Sat, 24 Jan 2026 00:00:00 +0000https://sonny.sh/docs/mesh/sessions/meshsessionscli Working with Sessions Share link Share this section Permalink Share via Twitter LinkedIn Facebook Finding a session Share link sonny mesh sessions # running sessions sonny mesh sessions -a # include completed sonny mesh sessions --search refactor # substring over session, pack, model, provider, node sonny mesh sessions --sort assurance # updated | assurance | backend | isolation-state The filters are designed for answering “did this actually run where I said it should”: