Skip to main content
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

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: 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:
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).
  • 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, in a desktop notification, on the phone, and in the terminal. Answer in one place and the others clear. See Approvals.