Skip to main content
When you finish these steps, your iPhone shows on the Phones page as your own phone, and agents in your workspace can use it. Your iPhone connects through the Lusor Mac app. The app installs a small driver on the iPhone, called Lusor Link, that lets agents see the screen and tap, type and swipe. The setup takes a few minutes, most of it while the driver installs.

​
Requirements

  • A Mac with Apple silicon. The Lusor Mac app does not run on Intel Macs.
  • macOS that can run the current Xcode from the Mac App Store.
  • Full Xcode, not just Command Line Tools. Install Xcode from the Mac App Store (about 15 GB), open it once and accept the license. Lusor uses Xcode to sign and install its driver. Xcode also needs its iOS component. If it is missing, Lusor offers to install it during setup.
  • An Apple ID signed in to Xcode. Either works:
    • A free personal Apple ID. The signing lasts 7 days, so you sign again every week.
    • A paid Apple Developer account. The signing lasts for the year, with no weekly reminder.
    Your Apple ID stays in Xcode and is never sent to Lusor.
  • A USB cable that carries data, for the first connection. After that, the iPhone can connect over Wi-Fi.
  • An iPhone with Developer Mode, which means iOS 16 or later, and its passcode.
  • A free phone slot on your plan. Your iPhone uses one slot. See Plans and credits.

​
Install the Mac app and sign in

  1. Install the Lusor Mac app and open it.
  2. On Sign in to Lusor, choose Continue in browser, then sign in or create an account in your browser.
  3. If Lusor asks Which organization?, pick the one this iPhone is for.
  4. On Which workspace?, pick the workspace the iPhone should join, then choose Continue.
  5. On Now pair your iPhone, choose Pair my iPhone.

​
Plug in your iPhone

  1. Unlock your iPhone and connect it to the Mac with the USB cable.
  2. On Connect your iPhone, choose Next.
Keep the iPhone unlocked until setup finishes. Connect only the iPhone you want to set up. To add more iPhones later, see Add another iPhone.

​
Trust This Computer

  1. On the iPhone, the Trust This Computer? alert appears. Tap Trust.
  2. Enter your iPhone passcode.
  3. On the Mac, choose Detect my iPhone.
If the alert does not appear, unplug the iPhone, plug it back in and unlock it.

​
Turn on Developer Mode

  1. On the iPhone, open Settings → Privacy & Security → Developer Mode.
  2. Turn Developer Mode on.
  3. iOS asks you to restart. Tap Restart.
  4. After the iPhone restarts, unlock it. iOS asks whether to turn on Developer Mode. Tap Turn On, then enter your passcode.
  5. Keep the iPhone unlocked and connected. On the Mac, choose Check my settings.
If Developer Mode is not in Privacy & Security, keep the iPhone connected to the Mac and trusted, then open Settings again.

​
Choose how to sign the driver

On Choose signing method, pick the kind of Apple ID you use in Xcode:
  • Personal Apple ID: free, re-sign every 7 days.
  • Apple Developer account: annual signing, no weekly reminder.
If Xcode is signed in to more than one Apple development team, Lusor asks you to Choose the Apple team for Lusor.

​
Install the driver

  1. On Install the iPhone driver, choose Build and Install.
  2. Wait while Lusor signs and installs Lusor Link on the iPhone. Keep the iPhone unlocked.
If Lusor shows Install iOS support for Xcode, choose Install iOS support and wait for the download to finish. It is large. Then choose Try again.

​
Finish and see it online

  1. Lusor launches the driver and adds the iPhone to your workspace. You see Adding to your workspace while this happens.
  2. When you see Connected to your workspace, setup is done. Choose Explore Lusor.
You can now unplug the cable. Your iPhone keeps working over Wi-Fi while it is on the same network as the Mac.

​
Keep the iPhone ready for long sessions

  • Keep the Mac on and online, with Lusor open. Agents reach your iPhone through the Mac app.
  • Keep the iPhone unlocked. When the iPhone locks, automation pauses and Lusor shows Unlock your iPhone. Unlock it, enter the passcode, then choose Reconnect.
  • Keep the iPhone on the same Wi-Fi network as the Mac, or connected with the cable.
  • Pause instead of unplugging. To keep agents off the iPhone for a while, choose Pause iPhone in the Lusor menu bar menu.

​
Check it works

  1. Open the Phones page at app.lusor.ai. Your iPhone is listed, and under its screen it says No agent on this phone rather than Offline.
  2. In the Lusor menu bar menu, the status reads Connected iPhones: 1, followed by the iPhone’s name.
  3. Start a chat on the iPhone and send a short task. See Your first task.

​
Troubleshooting

Connect an unlocked iPhone with a USB cable, tap Trust on the iPhone, and keep it unlocked while Lusor detects it. Then choose Try Again.If Lusor says No iPhone is connected, it remembers an iPhone from an earlier setup that it cannot reach now. Connect the iPhone you want to set up with a USB cable, unlock it and choose Try Again.
The iPhone has not trusted this Mac yet. Unlock the iPhone, tap Trust when asked whether to trust this computer, and enter the passcode. If the prompt does not appear, unplug and reconnect the iPhone, then choose Check Again.
Open Settings → Privacy & Security → Developer Mode on the iPhone and turn it on. Restart the iPhone, confirm Developer Mode after the restart, then choose Check Again with the iPhone unlocked and connected.
Command Line Tools alone are not enough. They do not include the iOS SDK Lusor needs. Choose Get Xcode to open Xcode in the Mac App Store. Install it, open it once, accept the license, then choose Try again.
Your Apple account has a development certificate for this Mac, but its private key is not on this Mac. This happens on a new, reinstalled or cleaned-up Mac.
  1. Choose Open Xcode.
  2. In Xcode, open Settings → Accounts, select your Apple ID and choose Manage Certificates.
  3. Add an Apple Development certificate. Accept Revoke if Xcode asks.
  4. Back in Lusor, choose Try again.
Xcode is using a provisioning profile that no longer exists. Open Xcode → Settings → Accounts, select your Apple ID and team, choose Download Manual Profiles, then choose Try again in Lusor.
Xcode has no Apple ID it can use to sign the driver. Choose Open Xcode, go to Settings → Accounts, sign in with your Apple ID and confirm the development team. Then choose Try again.If Lusor says Choose one Apple ID in Xcode, Xcode is signed in to more than one development team. In Xcode, choose Settings → Accounts, keep only the Apple ID you want Lusor to use, then choose Try again. If Lusor instead shows Choose the Apple team for Lusor with a list of teams, pick the team there.
Lusor could not finish installing the driver. Keep the iPhone unlocked and connected, then choose Build and Install again. If it repeats, open Diagnose, copy the technical detail and send it to support@lusor.ai.
The driver launched, but Lusor did not get a working connection within two minutes. Keep the iPhone unlocked and on the same network as the Mac, then choose Reconnect.
Added by another user means someone else in your workspace added this iPhone. It reconnects when that person signs in to Lusor on this Mac.Enrolled to another workspace means the iPhone belongs to a different workspace than the one you are signed in to. Nothing was moved. Switch to the iPhone’s workspace, or move it with Move this iPhone to this workspace.
The iPhone is set up on the Mac, but Lusor could not add it to your workspace. Choose Try reconnecting. Nothing is undone and you do not need to reinstall the driver.If the iPhone shows Not added · over your plan, your plan has no free phone slot. Upgrade your plan, or remove another phone, then try again.
Start setup over disconnects the iPhone from Lusor and runs setup again. The iPhone stays paired with the Mac and you stay signed in. Running setup again takes a few minutes.If the iPhone was set up by another Lusor user or account, Lusor changes nothing. Sign in as that user first, or move the iPhone to your workspace instead. When more than one iPhone is set up on the Mac, this button is called Remove this iPhone.

​
Add another iPhone

  1. In the Lusor menu bar menu, choose Find iPhones….
  2. Connect and unlock the new iPhone.
  3. Choose Set up next to it, then follow the same steps from Trust This Computer.

​
Known limits

  • Free Apple ID signing lasts 7 days. Lusor reminds you about 48 hours before it expires. When it expires, the driver stops launching until you open Lusor and sign again. A paid Apple Developer account avoids the weekly renewal.
  • Your Mac has to stay on. Agents cannot reach the iPhone while the Mac is asleep, offline, or Lusor is closed.
  • The iPhone has to stay unlocked for automation to run.
  • Internet and location settings do not apply. Your iPhone uses its own connection. Those settings are for Lusor Phones.
  • It does not use Lusor Phone minutes. Agent time on your own iPhone uses credits for the AI work but no Lusor Phone minutes.
To remove your iPhone from Lusor, see Remove a phone.