Repository navigation
v0.2.0 (development preview): iPhone support
Pre-release
Pre-release
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 pauselocks 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 upNotes
- 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.