Installation
Install AXe with Homebrew, add the AI skill if you use an agent, and check that your simulator or device is ready.
Requirements
| Requirement | Notes |
|---|---|
| macOS | macOS 14 Sonoma or later, on Apple silicon or Intel. |
| Xcode | Xcode 26 or Xcode 27, selected with xcode-select. One AXe binary runs with either. axe settings needs Xcode 27. |
| Simulator | A booted iOS simulator. The iPhone Duo commands need an iPhone Duo simulator runtime. |
| Physical device (optional) | An iPhone or iPad paired in Xcode, with Developer Mode on and the screen unlocked. |
Install with Homebrew
brew install cameroncooke/axe/axe
axe --helpUpgrade later with:
brew upgrade axeCheck a target
For a simulator:
axe list-simulators
axe doctor --udid <UDID>For a physical iPhone or iPad:
axe list-devices
axe doctor --udid <DEVICE_UDID>doctor checks that a simulator is booted, or that a device is paired, in Developer Mode, connected, unlocked and has its developer disk image and screenshot service. A failed check exits nonzero and names the check that is not ready.
Every command needs an explicit --udid. AXe looks the UDID up among simulators first, then among the devices Xcode knows.
Add the AI skill
If you use Claude Code, Codex or another agent, install the AXe skill so the agent knows how to drive the UI with agent mode:
axe initTo keep the skill updated as releases ship, install it from the AXe plugin marketplace instead:
claude plugin marketplace add cameroncooke/AXe && claude plugin install axe@axe
codex plugin marketplace add cameroncooke/AXe && codex plugin add axe@axeSee AI Skill for every option.
Build from source
See Contributing. Source builds need XcodeGen for the bundled IDBKit frameworks.
Next step
Open Quick Start and run AXe against a booted simulator.