Skip to main content
Pairing hands your phone and your computer a shared encryption key. No server ever sees it — which is why it takes a scan or a typed code rather than a login. You do this once per computer. The pairing expires if unused for 10 minutes.
One pairing covers the machine, not the agent. If you run any mix of Claude Code, Codex and OpenCode on the same computer, they share it — you don’t pair twice.
The normal path. Use it whenever you can open a browser on the computer.
1

Start pairing

A themed pairing page opens in your browser with a QR code.
The Nomo pairing page showing a QR code and a click-to-reveal one-time code

The pairing page on your computer. It flips to Paired ✓ on its own once the scan lands.

2

Scan it

In Nomo, go to the Sessions tab → Pair a Computer, and point the camera at the QR code.
3

Done

The page flips to Paired ✓ on its own and tears itself down. Your computer now appears in the Sessions tab.
The QR code and the one-time code appear only in that browser page, never in your terminal. That’s deliberate — terminal output ends up in agent transcripts, and these are the values an attacker would need.

Checking on it later

/nomo-cc:status on that machine reports whether it’s still connected and whether events are actually being delivered.

If pairing doesn’t take

  • No QR page opens — the plugin’s hooks probably didn’t load. Restart the agent and try again, or use the typed-code path.
  • The scan succeeds but no computer appears — run the status command above to see whether events are being delivered at all.
  • Computer Limit Reached — you’re at 5 paired computers. Touch and hold one in the Sessions tab, forget it, and pair again.
Anything else, and the fix is probably on Troubleshooting. To take a computer back off, see unpair.