Repository navigation
iCTRL 1.96.1
An AI-friendly iOS/iPadOS automation service. Tell your agent "My iPhone is running iCTRL at :8200 — figure out how to drive it." and it reads the on-device manual and takes it from there. Works with any agent that can make HTTP requests: OpenClaw, Hermes, Minis, Claude Code, Codex and others.
Downloads
| File | What it is |
|---|---|
iCTRLUITests-Runner.ipa |
The automation engine — required. |
iCTRL.ipa |
Optional host app: mounts the Developer Disk Image on the device and starts the runner. Use it or StikDebug. |
Both are unsigned for distribution (ad-hoc, no provisioning profile). Sign them when you install:
- Free Apple ID: the latest SideStore signs and installs them. Older SideStore releases skip the nested
.xctest, and the runner then crashes on launch. - Paid account:
Scripts/sign-ipa.sh -i iCTRLUITests-Runner.ipa
The runner also needs the Developer Disk Image mounted (Xcode, StikDebug or the iCTRL app). The README covers the whole setup.
Highlights since 1.32.0
- Settle-aware actions: taps, scrolls, typing and
open_urlwait until the screen stops changing and report what changed, ignoring motion the action didn't cause (running animations, video, Picture-in-Picture). - Bounded accessibility work: element lookups and taps by ref use capped tree walks, so slow or busy apps can no longer stall the UI queue.
- Reading screens:
collectreads a long list in one call and switches to OCR when the tree is thin;page_source enhanced:trueadds text drawn in images. - Screen-state flags: system alerts, overlays, loading indicators, login walls, anti-bot checks and promotional popups are reported with each read; refs refuse to act on a screen that has changed.
- Smoother remote control page (
GET /remote): screen capture is several times faster, the stream plays with low latency up to 30 fps, and the page supports horizontal swipes, long press, and right-click for Home. - Runner home-screen icon.
- iCTRL app: mounts the cryptex Developer Disk Image on iOS 26.4 and later, detects the LocalDevVPN tunnel by actually connecting through it, and checks network permissions on first launch.
SHA-256
17c9cdf84ad85306624a806ecf1866c602043b5e0207e139accc1d085f716b63 iCTRLUITests-Runner.ipa
b9df924ca13d80dcdc8628edc14142b0c3b3c358417f5ad1fd5656b4116556dc iCTRL.ipa