# Use Pane on your phone

import { Callout } from "nextra/components";

Your agents keep working when you walk away from your desk. Pair once and answer them from anywhere: home, office, café Wi-Fi or a phone hotspot. From your phone you get your terminals, your agents and their approvals, alerts when an agent needs you, previews of your dev servers, and the files in each [worktree](/docs/panes-and-worktrees).

<Callout type="warning">Your phone talks to Pane on your computer, so the computer has to be on, awake and running Pane.</Callout>

## Pair your phone in 3 steps

1. **Show the QR code on your computer.** Click **Pair a phone** on Home, or open **Settings → Remote Access → Add a device → Phone**.
2. **Point your phone's camera at the code.**
3. **Tap the link.** It opens the Pane app, or Pane in your phone's browser if you don't have the app.

A few seconds later your phone shows the computer's [Sessions](/docs/sessions) and Panes. The code works once and expires after 10 minutes, then the dialog shows a fresh one.

<Callout type="info">**Phone access** is this computer's connection to Pane's relay. Opening **Add a device → Phone** or **Computer** turns it on, and it stays on.</Callout>

## Pane app or browser?

- **The iPhone app** is in TestFlight, Apple's beta program. To get it, [ask to join on Discord](https://discord.gg/BdMyubeAZn). The app sends alerts to your lock screen and remembers your computer's key, so a look-alike server can't fool it.
- **Any phone's browser** works today, Android included. Tap **Continue in browser** after you scan.

<div style={{ display: "flex", gap: "16px", flexWrap: "wrap" }}>
  <Shot phone src="/docs/remote/phone-landing" width={780} height={1328} alt="The pairing page on a phone: Pair with Studio Mac, with an Open in Pane app button and a Continue in browser button." caption="What your phone shows after you scan." />
  <Shot phone dark={false} src="/docs/remote/phone-app" width={780} height={1328} alt="Pane in a phone's browser, connected to Studio Mac." caption="Pane in the browser, connected." />
</div>

Already in the Pane app? Scan another computer's code from **Settings → Add a machine**. If the phone already reaches other computers, the app asks first, because pairing [links them](/docs/your-computers) with the new one.

To pair Even G2 glasses, use the Pane app: scan the code from **Add a device → Wearables** with your phone.

## Where your phone shows up

Your phone appears on the computer under **Settings → Remote Access → Phones and glasses**. That's where you remove it.

Lost a phone? Click **Remove → Remove from all your computers**. See [Your computers](/docs/your-computers#remove-a-phone-or-a-computer).

## New to Pane?

When you first open Pane, it offers to pair a phone for you. Pick **Pair a phone**, or **Skip for now** and do it later from Home.

<Shot dark={false} src="/docs/remote/onboarding-take-agents" width={1400} height={900} alt="Pane's first-run card: Take your agents with you. Pair your phone with this computer, with Skip for now and Pair a phone buttons." />

## When something goes wrong

| What you see | What to do |
|---|---|
| "This code was already used" or "This code expired" | Scan the new code the computer shows. |
| "Reconnecting to Studio Mac…" | Nothing. The app retries at least every 5 seconds while it's open (once a minute after an hour). On the same Wi-Fi, the Pane app connects even when the internet is down. |
| "Asleep since 9:40" | The computer is asleep. Wake it, or turn on **Keep awake while sessions are active** in **Settings → General**. |
| The browser can't reach the computer on a Wi-Fi with no internet | A browser needs the internet to look up your computer's address. Use the Pane app instead. |
| "Phones can't connect: this computer's phone listener isn't running" | Another app, often a second Pane, holds the port phones use on your Wi-Fi. Quit that app, or pick a free port in **Settings → Remote Access → Tailscale → Advanced**, which holds it even if you don't use Tailscale. |
| "This computer can't be paired right now" | The computer couldn't reach Pane's servers. Check its internet connection, then click **Try again**. |

<a id="prefer-tailscale"></a>

## Next

- [How it connects](/docs/how-it-connects): what travels where, and how fast.
- [Your computers](/docs/your-computers): switch between computers, and remove a lost phone.
- [Security, in plain words](/docs/remote-security): who can read what.
- [Tailscale and Remote VMs](/docs/remote-daemon), if you'd rather use your tailnet.
