Skip to content

Releases

v0.2.0 (development preview): iPhone support

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.

v0.1.0 (development preview)

Pre-release

Choose a tag to compare

@luckeyfaraday luckeyfaraday released this 22 Oct 20:53

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 asked

The 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.