Changelog

What's Changed

Added

• Added axe slider --id/--label --value 0...100 for selector-based slider setting with orientation-aware HID dragging and AXValue tolerance verification/failure reporting.
• Added axe drag --start-x/--start-y --end-x/--end-y for raw point-to-point low-level HID drag validation using explicit touch move events.

Changed

• Changed axe slider to use the shared composite low-level HID drag path with AXValue tolerance verification instead of retrying with correction gestures.

Fixed

• Fixed describe-ui and selector-based tap --label exposing and activating real SwiftUI TabView tab items, navigation search fields, toolbar segmented picker items, and generated navigation back buttons from the CoreSimulator accessibility bridge. Also fixed selector decoding when the accessibility tree contains numeric AXValue fields such as sliders.
• Fixed tap, touch, swipe, and matching batch steps dispatching logical UI coordinates directly to FBSimulatorHIDEvent without landscape rotation or letterbox correction, causing interactions to land in the wrong location in rotated landscape simulators and portrait-hardware landscape-only apps. AXe now detects the simulator UI orientation automatically instead of requiring callers to pass landscape flags (#5 by @Nitewriter)
• Fixed selector-based tap and batch tap steps so UIKit UISwitch and SwiftUI Toggle controls can be activated reliably, including when a matched row or label contains a single switch/toggle control. Added --tap-style so switch/toggle taps can use physical touch automatically while normal taps keep the simulator tapAt path by default (#46).
• Fixed element comparison in AccessibilityTargetResolver to prevent distinct elements with the same type and frame but lacking labels/values from being incorrectly identified as identical during ancestor tree traversal.

Installation

Homebrew

brew tap cameroncooke/axe
brew install axe

Manual

Download AXe-macOS-v1.7.0-universal.tar.gz from the assets below and extract it.

Keep the extracted payload together:

axe
Frameworks/
AXe_AXe.bundle/

Then either run ./axe from the extracted directory or symlink that axe executable onto your PATH without moving it away from Frameworks/ and AXe_AXe.bundle/.

What's Changed

Added

• Added --value targeting for tap, allowing elements to be matched by their accessibility value in addition to --id and --label. Added --element-type filtering to narrow matches by element type (e.g., button, text field) (#40 by @andresdefi).
• Added --wait-timeout and --poll-interval options to tap for waiting until a matching element appears before tapping (#40 by @andresdefi).

Fixed

• Fixed describe-ui to expose and implement the documented --point option in command help and runtime behavior (#38)

Installation

Homebrew

brew tap cameroncooke/axe
brew install axe

Manual

Download AXe-macOS-v1.6.0-universal.tar.gz from the assets below and extract it.

Keep the extracted payload together:

axe
Frameworks/
AXe_AXe.bundle/

Then either run ./axe from the extracted directory or symlink that axe executable onto your PATH without moving it away from Frameworks/ and AXe_AXe.bundle/.

What's Changed

Added

• Added batch command for executing ordered multi-step interaction workflows in a single invocation, with sequential execution that supports multi-screen flows, built-in sleep delays, accessibility caching, and configurable text submission strategies (#25). See BATCHING.md.
• Added axe init command to install, uninstall, or print the AXe skill for AI clients (claude, agents) or a custom destination (#25).

Fixed

• Fixed Homebrew installation on Intel Macs by producing architecture-specific release artifacts (#27, #21)
• Fixed tap --label resolving ambiguous matches by preferring actionable elements over read-only ones (#28)

Installation

Homebrew

brew tap cameroncooke/axe
brew install axe

Manual

Download AXe-macOS-1.5.0.tar.gz from the assets below, extract, and place the axe binary on your PATH.

What's Changed

Added

• Added batch command for executing ordered multi-step interaction workflows in a single invocation, with sequential execution that supports multi-screen flows, built-in sleep delays, accessibility caching, and configurable text submission strategies (#25). See BATCHING.md.
• Added axe init command to install, uninstall, or print the AXe skill for AI clients (claude, agents) or a custom destination (#25).

Fixed

• Fixed Homebrew installation on Intel Macs by producing architecture-specific release artifacts (#27, #21)
• Fixed tap --label resolving ambiguous matches by preferring actionable elements over read-only ones (#28)

Installation

Homebrew

brew tap cameroncooke/axe
brew install axe

Manual

Download AXe-macOS-1.5.0.tar.gz from the assets below, extract, and place the axe binary on your PATH.

What's Changed

Added

• Added batch command for executing ordered multi-step interaction workflows in a single invocation, with sequential execution that supports multi-screen flows, built-in sleep delays, accessibility caching, and configurable text submission strategies (#25). See BATCHING.md.
• Added axe init command to install, uninstall, or print the AXe skill for AI clients (claude, agents) or a custom destination (#25).

Fixed

• Fixed Homebrew installation on Intel Macs by producing architecture-specific release artifacts (#27, #21)
• Fixed tap --label resolving ambiguous matches by preferring actionable elements over read-only ones (#28)

Installation

Homebrew

brew tap cameroncooke/axe
brew install axe

Manual

Download AXe-macOS-1.5.0.tar.gz from the assets below, extract, and place the axe binary on your PATH.

Added support for for long press gesture to touch command

Add key-combo command for atomic modifier+key presses (e.g., Cmd+A, Cmd+Shift+Z) Thanks toht @jpsim for the contribution!

Fixed homebrew installation error messages

• Add support for screenshot capture to PNG
• Add tap by label or accessibility id in addition to existing x/y coordinates
• Fix FBProcess duplication warnings

Special thanks to @aliceisjustplaying and @onevcat for their execellent contributions!

• Pin IDB version to address access control issues on new versions