Multiplayer
Multiple clients observing one session: shared output, collaborative input, and reconnect replay.
Run one agent session and let several clients watch and drive it at once. Reach for this when a session needs more than one viewer — pair programming, a shared review session, or a dashboard mirroring what an agent is doing live.
How it works
Clients connect to the same VM actor by id (getOrCreate("shared-agent")), so they share one session rather than spawning their own. Each connection subscribes to the same event stream — sessionEvent, processOutput, and shellData all fan out to every connected client. One client can create the session and sendPrompt, while others observe the streaming response without driving it. Because the server fans events out from a single session, the onSessionEvent server hook still fires once per event regardless of how many clients are attached. Every event carries a sequence number, so a client that drops can call getSequencedEvents({ since }) to replay what it missed before resuming the live stream.
Run it
npm install
# terminal 1 — start the server
npx tsx server.ts
# terminal 2+ — attach observers / drivers
npx tsx collaborative.ts
Multiple clients print the same session events; an observer sees the driver’s prompt response stream in real time.