Repository navigation
iCTRL 1.32.0
An AI-agent-friendly iOS 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.
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
- Faster: synthesized taps (~280ms median). Visible-screen reads under 1s even on long feeds. On-device OCR when the accessibility tree is empty.
- Reliable on busy and backgrounded apps: queries against an app that has left the screen are refused immediately instead of stalling the UI queue. Abandoned calls can no longer pile up and get the runner killed for CPU use.
- Better element targeting:
find_elementprefers on-screen matches and reportsvisibilityandalternatives.scroll_to_elementdrags straight to known positions and says when an element isn't in the view at all. - Controlled from notifications: long-press to approve pairing, toggle remote access, or stop the server.
- Builds from a fresh clone with
make ipaand nothing but Xcode and XcodeGen. - Now licensed under Apache-2.0 (previously AGPL-3.0).
SHA-256
9961e8146fe5f447fad9ec07768fe77682b4dfc47c309a01eaa210e80bf3038d iCTRLUITests-Runner.ipa
387f141d4fc160b5d3ff40d7d337d6c16874513ccb575e64ad52a121660a3959 iCTRL.ipa