Pairing
Just scan a QR code. Away from home? Connect securely over Tailscale.
Last updated: June 22, 2026
How to link the iPhone app with the Bridge on your PC. Pair once, and it reconnects automatically after that.
How to pair
- Launch BuddyOS (the Bridge) on your PC and show the pairing QR code.
- Open the iPhone app and scan the QR code.
- Once connected, your running agents are listed in the app.
Connecting on the go (Tailscale)
On the same Wi-Fi, the Bridge and iPhone connect directly over LAN. From another network, BuddyOS uses a secure link over your own Tailscale network (tailnet).
- Install Tailscale on your PC and sign in to connect from anywhere.
- The connection follows you automatically even when networks change.
- Traffic stays within your tailnet and never passes through our servers.
If it won't connect
- Check that the Bridge is running on your PC.
- If it won't connect while away, confirm Tailscale is signed in on your PC.
- If the QR doesn't appear, restart the Bridge and try pairing again.