Skip to content

iCTRL 1.32.0

Choose a tag to compare

@wsvn53 wsvn53 released this 09 Oct 03:33
· 49 commits to main since this release

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_element prefers on-screen matches and reports visibility and alternatives. scroll_to_element drags 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 ipa and nothing but Xcode and XcodeGen.
  • Now licensed under Apache-2.0 (previously AGPL-3.0).

SHA-256

9961e8146fe5f447fad9ec07768fe77682b4dfc47c309a01eaa210e80bf3038d  iCTRLUITests-Runner.ipa
387f141d4fc160b5d3ff40d7d337d6c16874513ccb575e64ad52a121660a3959  iCTRL.ipa