Repository navigation
Releases
v0.2.0 (development preview): iPhone support
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.
v0.1.0 (development preview)
First development preview of Phone-Use: let an AI agent read the screen, tap, type, scroll, open apps and take screenshots on an Android phone (7.0+), over MCP or from the terminal.
Install
npm install -g https://github.com/luckeyfaraday/phone-use/releases/download/v0.1.0/phone-use-mcp-0.1.0.tgz
phone-use-mcp setup # phone on USB with USB debugging; enable accessibility on the phone when askedThe npm tarball bundles the APK and setup installs it. phone-use.apk is attached separately for manual installs.
Notes
- Signed with the maintainer's development key. A later switch to a release key will require uninstalling this build once.
- Verified on an Android 7.0 emulator (details in docs/TESTING.md). Tailscale on a physical phone hasn't been tested with this package yet.
- Check downloads against
SHA256SUMS.
See the changelog for everything in this release.