Use case
Remote development
TL;DR
Run your agents on a bigger machine and keep your laptop for reading and reviewing. Install Pane on a home server, cloud VM or workstation and pair it with your phone by scanning a QR code. It works on any network, with no Tailscale. Pair your laptop with the same phone and the two computers link. Tailscale and connection codes still work, and headless daemon hosts use them. Agents keep working on the host when you close the lid, and everything is where you left it when you reconnect.
Agents use a lot of memory, CPU and battery, and several at once on a laptop means hot fans and a short afternoon. The work belongs on a machine built for it, while you keep the laptop for steering and review.
Why move the work
The laptop steers and reviews; another machine does the heavy lifting.
Running agents on a desktop, server or cloud VM gives them more memory and cores and keeps your laptop cool and quiet. It also means the work doesn't stop when you close the lid or lose Wi-Fi.
How it works
Same Pane, same shortcuts; the worktrees and agents live on the host.
The Pane app on your laptop becomes a client. Worktrees, terminals and agents run on the host. You see the same interface, use the same shortcuts and review the same diffs; only the machine doing the work changes. A host switcher in the sidebar lets you move between your own machine and remote hosts.
Kick off a task and close the laptop. The agent keeps going on the host, and when you open Pane again, its output and your place are waiting. Permission prompts reach every connected client and wait until someone answers.
Setting it up
Scan a QR code to pair, on any network. Tailscale and codes still work, and headless hosts use them.
- 1Install Pane on the machine that should do the work.
- 2On that machine, click Pair a phone and scan the QR code with your phone. It works on any network, with no account and no Tailscale.
- 3Pair your laptop with the same phone. The two computers link and list each other under Settings → Remote Access → Computers and in the machine menu at the top of the sidebar.
- 4Prefer Tailscale or a connection code? Open Settings → Remote Access → Tailscale. Codes from Set Up Host paste into
runpane.com/appin a browser. - 5For a server with no screen, run
npx --yes runpane@lateston it and follow the setup wizard.
Common setups
Any pairing where one machine has more power, or never sleeps.
- → Laptop and home desktop. Your desktop runs the agents; you check in from the couch or a café.
- → Laptop and cloud VM. An always-on machine for long or overnight work.
- → Laptop and office workstation. Use the big machine from anywhere.
- → Phone and any host. Check progress and answer prompts from the Pane iPhone app or your phone's browser.
A sleeping host runs nothing, so keep it awake or use an always-on machine; see what is session persistence? For other remote approaches, see Pane Remote vs alternatives.
Sources
- Corrections
- If anything here is wrong or out of date, tell us and we'll fix it and update the date at the top. Open an issue on GitHub
- Sources
Frequently asked questions
By Parsa Khazaeepoul, co-founder of Pane. .