Quick start

XPhoneUse mirrors a real phone to your desktop and hands it to an AI agent. It is still your device, your accounts and your app state — only the person working it changes.

Install

Grab the Windows installer from the download page and run it. If Apple Mobile Device Support is missing, the installer offers to add it — you do not need iTunes. Android needs no extra driver at all.

Start the app afterwards and let it reach the USB device.

Connect a device

Android

  1. Enable Developer optionsUSB debugging on the phone.
  2. Plug in the cable and tap Allow on the phone.
  3. The device appears in the app with its name and serial number — click it to start mirroring.

For cable-free work, turn on Wireless debugging in developer options and connect with wifi connect <ip>:<port>.

iPhone

  1. Unlock the phone and plug in the cable.
  2. Tap Trust This Computer.
  3. Pick the device in the app; the developer image the screen, touch, screenshots and pasteboard need is downloaded and mounted for you (about 16 MB the first time on iOS 27+; iOS 16 and older skip the tunnel but still need one for screenshots, ~7 MB).
  4. Installing that image needs Developer Mode: if it is off, the app warns for 10 seconds and then turns it on itself (the phone restarts once) - unlock it after the restart and connect again. You can turn Developer Mode off again once the image is mounted.

Over the tunnel, screen, input and screenshots all share that one cable. iOS 16 and older fall back to AirPlay mirroring automatically.

Mirror it

The window switches to the live screen. The toolbar carries navigation, rotation, volume, screenshots, recording and macros. You and the agent share one connection: watch while it works, or take over at any moment.

Hand it to your agent

Tell the agent you already use: Install the skill: https://xphoneuse.aovik.com/static/skills/xphoneuse.zip - it installs the skill itself and knows how to drive the phone from then on. Manually it is three lines:

python scripts/xphoneuse-cli.py list
python scripts/xphoneuse-cli.py connect <serial-or-udid>
python scripts/xphoneuse-cli.py screenshot

Or point an MCP client at the endpoint:

{
  "mcpServers": {
    "xphoneuse": { "url": "http://127.0.0.1:7070/mcp" }
  }
}

Next


Last updated 2026-09-17