PhoneDock

Your agent, on a real phone.

A free, open-source Mac app that lets Claude Code, Codex, Cursor and Pi use your iPhone, your Android phone, iOS simulators and Android emulators. You watch every step live, and the agent asks you when it needs your face or your password.

Download for Mac  ·  Website  ·  Watch the 47-second video

See it work

Real recordings at real speed, with the waits trimmed. Nobody touches the phones.

One window for every phone

• Watch live at up to 60 fps while an agent works, in the app or in a separate window.
• Real phones and virtual ones. iPhones on iOS 27 or later connect over USB or Wi-Fi with nothing installed on the phone. Android phones connect over USB or Wi-Fi. Create Android emulators and iOS simulators from real system images, with snapshots and clones.
• Every step in the Activity list. Each tap, swipe and screenshot, who did it and when.
• Take over and hand back at any time. While you hold a device, agents wait.
• Inspect the UI tree, logs (coloured by level, for one app or all), crashes and installed apps. Switch dark mode, text size and contrast to check a layout.
• Record the screen to an .mp4, or save a screenshot. What you capture in the app goes where macOS saves your own screenshots. Recordings an agent starts stay in PhoneDock's data folder, and the agent is told the path.

Put your agent to work

• Run your social accounts. Reply to comments and go through the feed in the real apps.
• Test your apps. Go through a build screen by screen, attach screenshots to the PR, and save the run as a test.
• Research in apps that have no website or API. Read and sort reviews in the Play Store, or look things up in any app on the phone.

It asks when it needs you

Some steps stay yours: Face ID, passwords, sign-ins, CAPTCHAs and payments. The agent stops and asks. If you're in another app, a notification asks you. Click Take Over, do the step, click Done, and the agent carries on from where it stopped. Can't Do It tells it why, so it can change course.

Quick start

You need Xcode for iPhone simulators, or the Android SDK for Android emulators (requirements). PhoneDock shows what's ready and what's missing, with the command that fixes it.

1. Install. Download PhoneDock-<version>.dmg from the latest release and drag PhoneDock to Applications. It's signed and notarized by Apple.

2. Connect your agent. Open PhoneDock, click Connect an Agent…, then Set Up next to Claude Code, Codex, Cursor or Pi. Or run it in Terminal:

   /Applications/PhoneDock.app/Contents/Resources/bin/phonedock setup
   

3. Ask your agent. Start a new session and try:

   Use PhoneDock to create an iPhone simulator, open Settings and turn on Dark Mode.

For every client it finds, setup registers PhoneDock's MCP server (user scope, so it works in every project), installs the phonedock agent skill and links phonedock into a folder on your PATH (if none can take a link, it gives you the line for your shell profile; agents use the full path, so they work either way). Then it checks each step and tells you what to fix if one fails.

It never replaces settings it didn't write: it reports them instead, and it backs up every file it changes. --dry-run shows the exact changes first; --uninstall takes them out again.

Supported devices

Device	Status	Notes
iPhone on iOS 27 or later	✅	USB or Wi-Fi with no app on the phone: live video, input and UI tree. Setup
Android phone	✅	USB, or Wi-Fi with wireless debugging
iOS simulator	✅	Simulator-built apps only
Android emulator	✅	Android SDK emulator, Google APIs and Play Store images
iPhone on iOS 26 or earlier	Beta	Needs WebDriverAgent on the phone. Setup

Generic OS images (QEMU) and Corellium cloud devices are experimental; see docs/ARCHITECTURE.md.

1. On the phone, turn on Settings › Developer options › Wireless debugging, then tap Pair device with pairing code and keep that screen open.
2. In PhoneDock choose Connect a Phone › Android. Your phone appears in the list (or run phonedock discover --android). If it doesn't, Use a QR code instead shows a code to scan from the phone's Pair device with QR code, and Enter an address takes the IP address and port the phone shows.
3. Type the six-digit code next to the phone and click Pair, or run phonedock pair 123456.
4. That's it: PhoneDock connects and the phone shows up in the sidebar. Next time, if the phone is already paired, click Connect (or run phonedock connect).

If macOS blocks it, PhoneDock says why. Either turn on PhoneDock in System Settings › Privacy & Security › Local Network, or click Restart adb and Try Again (CLI: --restart-adb; it briefly disconnects other tools that use adb, such as Android Studio).

This is the beginning of the README. Read the rest at the original. Read the full README ↗