Skip to content

v0.2.0 (development preview): iPhone support

Pre-release
Pre-release

Choose a tag to compare

@luckeyfaraday luckeyfaraday released this 22 Oct 23:50

iPhone support. Agents now use the same 11 phone_* tools on an iPhone as on Android.

iOS doesn't let an app control other apps, so the iPhone is driven from the computer it's plugged into: phone-use-mcp ios up keeps WebDriverAgent running over USB with go-ios and serves the same token-protected API as the Android app. Other computers on your tailnet can connect to it with ios up --network.

  • Locking the iPhone stops the agent, and only unlocking it on the phone resumes. phone-use-mcp pause locks it from the computer.
  • WebDriverAgent gets no network port. It has no authentication of its own, so phone-use reaches it over USB only.
  • No new dependencies. Screenshots are scaled by a small built-in PNG module.

You need an iPhone with Developer Mode, go-ios, and WebDriverAgent signed with your Apple ID. Start with the iPhone guide.

Install

npm install -g https://github.com/luckeyfaraday/phone-use/releases/download/v0.2.0/phone-use-mcp-0.2.0.tgz
phone-use-mcp setup        # Android
phone-use-mcp ios setup    # iPhone, then: phone-use-mcp ios up

Notes

  • Development preview, signed with the same key as 0.1.0, so it installs over it on Android.
  • iPhone support is verified on an iPhone 13 Pro with iOS 26 from Linux. macOS and Windows hosts should work through go-ios but are untested. Details are in testing.
  • Check downloads against SHA256SUMS. Full list of changes in the changelog.