Skip to content
This repository was archived by the owner on Nov 9, 2026. It is now read-only.

v0.1.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Nov 01:58
· 10 commits to main since this release
v0.1.0
266849f

First release.

iphone-control-toolkit lets an AI agent operate a real iPhone plugged into a Linux machine, through MCP.

  • 13 MCP tools: screenshots with region zoom, element tree, tap by name or coordinates, swipe,
    text input (including Chinese), hardware buttons, app management, open URL
  • WebDriverAgent as the primary control path, CoreDevice HID (iOS 27+) as automatic fallback
  • Supervisor that recovers from replugging, phone reboots, tunnel drops and WDA crashes, and
    re-signs WDA with a free Apple ID before the 7-day profile expires
  • Telegram / Bark alerts; optional auto-unlock with per-digit verification
  • iphonectl setup guided install, iphonectl doctor layer-by-layer diagnostics

Tested on iPhone 15 Pro Max with iOS 27.0.1 and an x86_64 Debian host.

Container image

docker pull ghcr.io/derrors/iphone-control-toolkit:0.1.0

Digest: sha256:334a2af65e3ddd6cca8f4f3945a6855c20bc2b12f4af2693f9f9a56319fe462d (linux/amd64). Verify provenance with
gh attestation verify oci://ghcr.io/derrors/iphone-control-toolkit:0.1.0 -R Derrors/iphone-control-toolkit.

Third-party source code

The image contains GPL and LGPL components (pymobiledevice3, usbmuxd, libimobiledevice and others).
Their complete corresponding source is attached to this release — see SOURCES.md.

Full Changelog: https://github.com/Derrors/iphone-control-toolkit/commits/v0.1.0

Assets 7
Loading