Pair devices

Pairing connects an installed runner to a signed-in person. A device that is not paired gets no tools. See Devices for the idea. Each employee pairs their own computer.

Before you start

The employee has an account and has installed the runner.

Pair a device (employee steps)

Sign in to the portal at app.scenery.dev.

Expected: the portal home page opens. If the person has no device yet, a Pair a device button is shown.
Choose Pair a device (or open My Devices), then expand Add a new device.

Expected: a panel titled Install the Scenery agent shows the install commands and a pairing command that looks like scenery auth pair <code>, with a countdown. The panel says Waiting for agent to connect.
In a terminal on the laptop, run the pairing command exactly as shown.
Terminal window
```
scenery auth pair <code>
```
Expected: the terminal prints Paired successfully.
Go back to the portal.

Expected: the panel closes and the laptop appears under My Devices with status Active. This usually takes a few seconds.
Restart Claude Code (or the AI client in use).

Expected: the Scenery tools are available in the client.

If you ran scenery auth pair with no code, the command asks you to paste it.

What a code is

A pairing code works once and expires after about 10 minutes. The portal shows a countdown. If it runs out, choose Refresh code to get a new one. Collapsing and reopening Add a new device also creates a new code.

Confirm as an admin

In the admin portal, open Devices under Activity.

Expected: a table with User, Hostname, Platform, Status, Agent Version, Last Seen and Installs. The new laptop is listed. Counts at the top show active, offline and stale devices.
Select the device row to see its details and what is installed on it.

Expected: a panel with the hostname, registered date, last seen, and the list of tools on that device.

Device status

Status	Meaning
Active	The device checked in recently.
Offline	No check-in for about 5 minutes. Usually a closed laptop.
Stale	No check-in for more than 7 days.
Needs re-auth	The runner is running but the person’s sign-in has expired. They run `scenery auth login`, then `scenery daemon restart`.
Waiting for agent	The device is registered but the runner has not started on it yet.

An offline or stale device does not receive new installs or removals until it comes back.

scenery auth login signs in through the browser and also registers the computer. Pairing with a code is the path shown in the portal and works well on machines where a browser sign-in is awkward.

Rename or remove a device

Employees can rename a device with the pencil icon on My Devices.
Remove on My Devices unregisters the device and clears its tool installs. A runner that is still running on that machine registers again by itself.
Admins cut off a lost or retired device with Revoke Device. See Kill switches.