Repository navigation
iCTRL 1.98.15
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
Which IPA do I need?
| File | Needed? | What it is |
|---|---|---|
iCTRLUITests-Runner.ipa |
Required | The automation engine. It serves the JSON-RPC API that agents and clients call, and must be running. |
iCTRL.ipa |
Optional | A companion app for tasks on the phone itself: • mount the Developer Disk Image without a Mac, and remount it after a reboot • start and stop the runner • choose who can reach the runner (this device only / LAN / LAN + nearby) • see and revoke authorized clients • read the runner's log live |
Skip iCTRL.ipa if you mount the Developer Disk Image with Xcode or StikDebug, and manage the runner from its notification or a computer. With a free Apple ID you get three sideloaded apps, and SideStore uses one of them. Install StikDebug or the iCTRL app alongside the runner, not both.
Both IPAs 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.
What's new since 1.98.12
Streaming
- Less heat while the screen is still. The video stream skips frames identical to the last one and slows capture while nothing changes. It sends a periodic heartbeat, and a keyframe whenever a viewer joins.
- No more black stream after the runner goes to the background. The encoder is rebuilt when iOS invalidates it.
Remote page
- Settings survive reloads. FPS, quality and verbose are kept in the browser.
Typing
- Custom input fields that drop focus. Some fields, such as chat input bars, lose focus as soon as
typesends key events.typenow detects this, refocuses the field and taps the on-screen keyboard keys instead (via:"keyboard"; Chinese is entered through pinyin candidates). It never presses Send. Passvia:"keyboard"to use this path directly. typereports failures. If the text can't be entered,typereturns an error instead of success.keyboard.visibledetects third-party keyboards such as Gboard.
Security and pairing
- More methods need authorization. Every method that reveals or changes device state now needs the device itself or a key.
- The iCTRL app imports RemotePairing files, such as StikDebug's
pairingFile.plist.