Pair your Mac

Pairing links a Mac to your account. Once paired, that Mac shows up in your dashboard and accepts the actions you send from your phone, browser, terminal, Siri, or a Claude Code hook. You pair each Mac once.

Steps

On any device — your phone, the same Mac, another computer — open:

https://app.commandlatch.app

Enter your email address and submit. We email you a sign-in link — open that email and tap the link. It returns you to the dashboard, signed in. No password required.

2. Find the 6-digit code on the Mac

On the Mac running CommandLatch, the pairing code is shown in two places — use whichever is in front of you:

The setup wizard that opened on first launch (the big “Pair this Mac” screen), or
The menu-bar icon → the top item reads Pairing code: 123456.

The code looks like 123456 and is good for about 10 minutes. If it expires, the app shows a fresh one.

3. Enter the code in the dashboard

In the dashboard, find Pair a device, type the 6-digit code, and submit.

4. Confirm it worked

Within a few seconds:

The device appears under Your devices in the dashboard and shows Online · a few seconds ago (it refreshes live).
On the Mac, the wizard advances to You’re set on its own, and the status in the menu bar flips to Paired.

The Mac is now paired. Click any action button to test it (start with Lock). See Use the dashboard.

What pairing sets up for you

Pairing on the Mac also configures the command-line tool automatically. So if you installed the CLI, commandlatch works on that Mac with no extra steps — no separate login required. Check it with commandlatch status.

Re-pairing or moving to a new account

To unpair a Mac — for example to pair it to a different account, or before uninstalling:

On the Mac: Settings… → Pairing → Unpair this device. This removes the local pairing record and the CLI config, and the app shows a new pairing code so you can pair again.
In the dashboard: open the device and use Remove this device. This deletes it from your account.

Do both for a clean reset: remove the device in the dashboard, then unpair on the Mac (or vice-versa), then pair fresh with a new code.

Notes & limits

One Mac per pairing. Each Mac holds a single pairing record. Pairing again replaces it.
The code expires after about 10 minutes. Get a fresh one from the menu bar if it lapses.
You can also pair from the terminal using commandlatch pair — see the CLI reference. Most users won’t need this.

Trouble pairing?

The code didn’t work / “expired.” Get a fresh code from the menu bar and try again — codes are short-lived.
The sign-in email didn’t arrive. Check spam, wait a minute, and re-request it. Make sure you typed the address correctly.
Paired but stuck “Offline.” The Mac must be awake and online for the heartbeat to land. See Troubleshooting → device offline.

More fixes: Troubleshooting.