Shared projects
Pair two AgentGrid desktops and open the same project on both — panes, terminals, notes, and layout stay in live two-way sync.


In this guide
Open a project from one computer running AgentGrid on another. Panes, terminals, notes, titles, and layout sync live in both directions, and an in-progress harness or terminal pane resumes on the second device with its full screen intact.
This is desktop ↔ desktop. For the phone/tablet companion, see Mobile app. Pairing and sharing with another computer need AgentGrid Pro.
Which projects a paired computer sees
There is no per-project share step. Once you pair two desktops (below), the second one can open the host desktop's recent projects, up to the last 10 you opened there, plus any project shared from it earlier. A headless host started with the agentgrid command line offers only the projects added with agentgrid project add.
Settings → Devices → Advanced → "Shared projects" lists everything this computer offers. A project shared earlier that isn't a recent project has an Unshare button.
Projects are matched by absolute path on the host. A paired computer can only read or write workspaces under a project the host offers; anything outside is rejected by the host.
Pair another device
Pairing is a one-time, two-sided handshake. Both devices need to be running AgentGrid and reachable to each other on the network. Computer-to-computer pairing also needs the background service: turn on Settings → Advanced → Keep workers and terminals running in the background on both computers, then restart AgentGrid.
On the device that has the project (the host)
- Open Settings → Devices → Advanced. In the Generate pairing link card, optionally type a Device name, then click Create pairing link.
- A pairing panel appears with:
- A Pairing link with a Copy link button.
- A 6-character code with an Expires in countdown (5 minutes).
- A QR code for the same link.
- The host's reachable addresses under On the other device, enter this host:, with the first one marked primary, each with its own Copy button.
- Copy code and Done buttons.
On the second device (the client)
- Open Settings → Devices → Advanced and click Connect in the Computers you can access card.
- Paste the Pairing link from the host. To type it in by hand instead, click Use a code instead and fill in Pairing code and Computer address.
- Click Connect. The host now lists this device under Devices with access here, and this device lists the host under Computers you can access.
Pair codes are kept in memory on the host — restarting AgentGrid invalidates any outstanding code.
Open the host's project on the second device
From the second device's empty project picker, click Open Remote Project. Your computers are listed first, then any other paired computers under Paired computers. Pick one and its projects load, then click a project to open it. A computer that can't open from here yet is greyed out, with the reason under its name.
If the computer has no recent projects yet you'll see "No recent projects on Studio yet" (with your computer's name), with Enter a path manually below it.
Pair the second desktop with the host, then use Open Remote Project to open one of the host's recent projects.
Diagram by AgentGridWhat syncs
Sync is live and two-way. Anything you do on one device shows up on the other within the same tick:
- Panes — added, removed, and reordered in the canvas z-stack.
- Layout — pane position and size as you drag and resize.
- Titles — both pane titles and title panes.
- Notes — title and body, as you type.
- Terminals and agents — the underlying PTY is owned by the host; both devices see the same live output and either device can type into it.
Resume an in-progress session on another device
Long-running harness panes and plain terminals do not get re-spawned on the second device. The host's daemon owns the process and replays its current state when the second device attaches, so the pane opens with its existing transcript and you continue where you left off. Keystrokes from either device reach the same session.
Revoking a pairing
Settings → Devices → Advanced → Devices with access here lists every device that has paired with this host. The Revoke access button on a row closes every live connection from that device immediately and removes its token; the device has to pair again from scratch to come back.
Network and transport
A remote pairing token is bound to the Tailscale address range it was issued for and can't be replayed from a public address. Loopback tokens are bound to 127.0.0.1 / ::1.
Shared projects vs. the mobile companion
Computers pair with each other through Settings → Devices → Advanced → Generate pairing link, the flow on this page. A paired computer can open only the projects the host offers.
Phones and tablets don't pair that way. They sign in to the same account and reach your computer through the AgentGrid relay, with no pairing step. See Mobile app.
Related
- Spaces and project folders — a remote project folder opens as a normal space on the second device.
- Mobile app — the phone/tablet companion flow.
- Terminals — the same PTY model that makes terminal panes resume cleanly on a second device.