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.
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:
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.