
One CLI for iOS simulators, including the dual-screen iPhone Duo simulator, and connected iPhones and iPads. Read the accessibility tree, tap, type, swipe and draw, capture screenshots and video, and change device settings. Agent mode gives AI agents checked, stateful control of the UI.
One set of commands, one set of error codes, every target
iPhone and iPad simulators on Xcode 26 and 27, in every orientation.
Both screens of the dual-screen iPhone Duo simulator, in every fold and orientation, with hinge control.
Connected devices over Xcode's CoreDevice. Pass the hardware UDID to the same commands.
Read the screen, drive any input, capture the result and configure the device, from your terminal.
The full accessibility tree as JSON, or the element at one point. Tap by ID, label or value, and wait for elements to appear.
Taps, long presses, double and two-finger taps, swipes, scroll-until-visible, pinch, rotate, drag to reorder and one-finger drawing.
Type text from an argument, stdin or a file. Single keys, key sequences and shortcuts such as Cmd+A by HID key code.
PNG screenshots, H.264 MP4 recording, MJPEG, JPEG and BGRA streams, and native H.264 from a physical device.
Dark mode, text size, contrast, reduce motion, colour filters, VoiceOver, a simulated location and a clean status bar.
Put --output json before any command for one typed result, or a typed error code to branch on. JSON Schemas describe every result.
Home, lock, side button, Siri and Apple Pay. Rotate the iPhone Duo simulator or a physical device and wait for the new orientation.
Run many input steps in one command and one input session, with selector waiting between steps.
Compact captures with refs, actions checked against the screen the agent saw, and the settled screen in every reply.
Every interaction is one command with an explicit target. Coordinates are points in the current orientation, and AXe handles rotation, letterboxing and each iPhone Duo simulator screen for you.
snapshotID 3FF70D78-… e7|tap|text-field|First name| e9|tap|text-field|Last name| e12|tap|button|Save|
Add --agent and every read and action is checked. AXe confirms the control is still the one the agent saw, sends the input and returns the new screen, so an agent never taps the wrong thing after a layout change and needs no extra read.
Automate connected iPhones and iPads, and every screen and fold of the iPhone Duo simulator, with the commands you already use.
Pass the hardware UDID to screenshots, accessibility reads, selector taps, gestures, typing, buttons, batches, rotation, settings and video, including native H.264. doctor tells you exactly what a device still needs.
Every input, read and capture command works on the dual-screen simulator, on whichever screen is active, in any fold and orientation. Show the screens, move the hinge, rotate, guard input to one screen, and record one movie through every fold.
The AXe skill teaches your coding agent to test and operate iOS apps with agent mode.
Run axe init to install the skill bundled with your binary, or add the AXe plugin marketplace to Claude Code or Codex so the skill stays updated as releases ship.
Agents capture the screen, act on refs, batch same-screen actions and verify from the screen each action returns.
Works with your favourite AI tools
Measured on an iPhone 18 Pro simulator against AXe 1.8.
Practical iOS automation for terminals, scripts, CI jobs and AI agents.
Shell commands that fit scripts, CI jobs and agent workflows. No server, no test target, no app changes.
AXe never picks a device for you, never replays uncertain input, and blocks input if a touch might still be held.
A warm input connection is reused across commands, so a simulator tap takes about 80 ms.
Simulators and devices share one error vocabulary. Branch on error.code, not on message text.
Agent mode, a bundled skill and plugin marketplaces make AXe the iOS hands for your coding agent.
Built on Apple's accessibility APIs. Target elements by ID or label, not just coordinates.
Install AXe with Homebrew. Requires macOS 14 or later and Xcode 26 or 27.
Install with Homebrew:
brew install cameroncooke/axe/axeCheck a booted simulator or connected device:
axe doctor --udid <UDID>Teach your AI agent to use AXe:
axe initAXe is MIT licensed and welcomes contributions. Help shape the future of iOS automation.