Sessions across devices

Every machine keeps its own session index. agents sessions --host runs the same query on a remote's index over SSH and streams the result back — no daemon, no shared store, SSH is the only auth.

Fan a query across machines

--host <target> is repeatable — pass it several times to query multiple machines in one command. Targets are a device alias or a raw user@host:

agents sessions "webhook signature" --host mac-mini
agents sessions "webhook signature" --host mac-mini --host studio
agents sessions --all "deploy script" --host box-a --host box-b

What's running right now

--active shows live sessions across terminals, teams, cloud, and headless runs. --local restricts it to this machine:

agents sessions --active          # everything running, everywhere
agents sessions --active --local  # only this machine
agents sessions --active --waiting # only sessions blocked on your input

Resume a remote session

resume reopens sessions in terminal tabs or splits — pass --host to resume one that lives on another machine:

agents sessions resume <id> --host mac-mini

Sync history across the fleet

Two ways to keep transcripts consistent across machines:

• agents sessions sync — a CRDT union over R2. Merges transcripts from every machine with no conflicts (Claude and Codex).
• agents drive push / pull — rsync your session history to a machine you control (beta). Set the remote once with agents drive remote user@host, then push / pull.

agents sessions sync              # CRDT merge over R2
agents drive remote user@studio  # one-time setup
agents drive push                # upload local sessions
agents drive pull                # merge remote sessions in

Related

• Devices overview — the one-flag model.
• Sessions — searching and reading transcripts locally.
• Remote runs — where remote sessions come from.