> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Devices

> Pair your phone and your other computers, send work between them, and approve from wherever you are.

**Manage → Devices** shows this computer at the center, with the devices paired to it around it. Phones sit above, peers below, the computers this one leads on one side, and those that lead it on the other. An empty slot pairs one more.

## Pair a phone

**1. Show the code**

Press **Pair a phone** in **Manage → Devices**. On a computer with no screen, run `archetype pair --phone` and paste the link it prints into the phone.

**2. Scan it**

In the phone app, tap **Scan the code** and point the camera at it. **Other ways to connect** lets you paste the link instead.

The phone reaches the computer over the same Wi-Fi, over Tailscale, or through a relay (your company's host, or the one `phones.relay` names). Whatever passes between them is sealed end to end, and a relay passes it on without reading it. To unpair, remove the phone in **Manage → Devices**. The phone then asks you to pair again.

## What the phone does

| Tab or screen | What it shows |
| - | - |
| **Now** | What waits on you, answered in place; what's running; recent conversations |
| **Work** | Your folders and their conversations; **Scheduled** at the foot; plugin pages |
| A conversation | The full conversation as it happens; send requests with photos and voice notes; **■** stops a request |

Approvals come with **Allow**, **Always** and **Deny**. Questions come with the agent's suggested answers, a field for your own, and **Skip**. **Ask anything** starts a new conversation.

Notifications come for an approval or a question that's waiting, and for a request that failed or finished after a while. They say what kind of thing it is and which conversation it's in, but not what's in it. Tap one to open the conversation.

## Your other computers

Pair them in **Manage → Devices** too. Choose what the other computer will be to this one:

| Choice | What it means |
| - | - |
| **Pair a peer** | Each computer sends the other work, and each sees the other's sessions |
| **A computer I lead** | This computer sends it work; it sends nothing back |
| **A computer that leads me** | It sends work to this computer. With **Only watch**, it can only list and read sessions here |

Computers on the same Wi-Fi, on Tailscale or in your team show up under **Nearby**. Pick one, then accept on the other computer, but only if both screens show the same six digits. You can also show a code instead: **Copy command** gives you `archetype pair '<link>'` to run on the other computer, and **Use a code from another computer** takes a link someone pasted. From the terminal:

```bash theme={null}
archetype pair            # print a code for another computer (good once, for ten minutes)
archetype pair LINK       # pair with the computer that printed LINK
archetype computers       # list paired computers and whether each answers
```

Each row shows the other computer's version, and **Older** if it's behind. A computer you lead can be updated from here with **Update**. If you don't want a computer that leads this one to update it, turn off **Let NAME update this computer**.

## How work reaches them

* **The sidebar** lists each computer you can reach, along with its sessions. Opening one opens it on that computer: its history, live progress and approvals.
* **Arch** may send a new goal to another computer when its folder is there ([Arch](https://docs.archetype.ing/en/use/arch.md)).
* **Move to NAME…** in a conversation's menu moves the conversation and its folder's current work, through Git. Files that look like secrets (`.env`, keys) stop the move. On the computer it came from, **Bring back the work from NAME** fetches the work onto a branch.
* **Agents** can send messages to sessions on a paired computer, and start work there.

Work that goes to another computer keeps its permission mode, but never more than that computer allows. That computer's own rules still apply.

## Approve from anywhere

Approvals and questions show up everywhere you are: in the conversation, in [Arch](https://docs.archetype.ing/en/use/arch.md), in a desktop notification, on the phone, and in the terminal. Answer in one place and the others clear. See [Approvals](https://docs.archetype.ing/en/use/approvals.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.