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
- Enable Developer options → USB debugging on the phone.
- Plug in the cable and tap Allow on the phone.
- 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
- Unlock the phone and plug in the cable.
- Tap Trust This Computer.
- 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).
- 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
- Driving it from an agent — the verb table, coordinates and verification
- iOS support — the tunnel, the paste alert, the keyboard
- Troubleshooting
Last updated 2026-09-17