Installation
Requirements
Section titled “Requirements”- Mac: macOS 14 or later, Apple Silicon or Intel
- iPhone / iPad: iOS 18 / iPadOS 18 or later
- At least one supported agent, such as Claude Code, Codex or Cursor, installed and signed in on the Mac
Android phones aren’t supported yet. No account to sign up for.
Your Mac needs to stay on while you use UULink. It keeps the Mac from going to sleep when idle by default, but closing a laptop lid still puts it to sleep, and your phone can’t connect.
UULink doesn’t download or install agents for you. For each agent’s install command, sign-in method and website, see Supported agents; for an agent that isn’t detected, Settings › Agent on the Mac also shows how to install it and a link to its website.
1. Install on the Mac
Section titled “1. Install on the Mac”On your Mac, download the latest UULink, a file named UULink-<version>.dmg. Open it, drag UULink (UULink.app) into Applications and launch it. A setup assistant appears on first launch:
- AI assistant: UULink detects Claude Code, Codex, opencode and Pi on the Mac automatically; you can continue once any of them is available. If neither is found, the assistant lists Claude Code, Codex and opencode with a short description, install commands and website; install any one of them in Terminal, sign in, then click Detect Again. For other agents, click + to add one and see how to install it, or point to its executable. Other agents can be added later in Settings › Agent; see Supported agents.
- System permissions: if your projects are in Documents, Desktop, Downloads or on an external disk, grant access as prompted; elsewhere (such as
~/Projects) you can skip this. - Control the desktop: optional, and can be turned on later in Settings › Control Desktop; see Control the Mac desktop.
- Pair Phone: shows a pairing QR code. Keep it open and scan it once the phone app is installed.
UULink then lives in the menu bar. To pair another device later, click the UULink icon in the menu bar and choose Pair New Device… (⌘ P). You can turn on Open UULink at Login in Settings › General, and allow UULink in System Settings › General › Login Items.
2. Install on iPhone
Section titled “2. Install on iPhone”Search for “UULink” in the App Store on your iPhone, or open the App Store page.
Then open UULink, tap Scan Code to Add Mac and scan the pairing QR code on your Mac (the system Camera app works too). On a device without a camera, click Copy Link in the Mac’s pairing window, send it to the phone (for example with Universal Clipboard) and choose Or Paste a Pairing Link. A pairing code is valid for 10 minutes and works only once.
On first connection iOS asks whether UULink may access your local network. Allow it so the phone and Mac connect directly on the same network, which is faster; if you deny it, UULink still works through a relay.
The app embeds its own iroh node — no other app to install, and it doesn’t use the system VPN slot.
For completion notifications, tap Turn On Notifications in the app’s Settings › Notifications, or Turn On in Settings if you denied it before.
3. Start using it
Section titled “3. Start using it”- Add a project by browsing folders on your Mac.
- Pick an existing git worktree or create a new one.
- Start a new session and choose an agent, or open an existing one (including sessions started directly in the Mac’s terminal, except for DeepSeek Harness and Antigravity).