Initial release of agent-ios - drive the iOS Simulator from the command line the way agent-browser drives a browser. Built for AI coding agents, useful for humans too.
Highlights
- Accessibility snapshots with element refs (
@e1,@e2, ...), plus tap / double-tap / long-press, drag, swipe, type, key presses, screenshots, and system-alert handling. - A custom in-simulator XCUITest runner with a zero-dependency HTTP server, built and launched on demand and cached under
~/.agent-ios. - Attach to any foreground app or a specific bundle id - works with native, SwiftUI, UIKit, React Native, Expo, and Flutter apps.
- 100% public Apple APIs (no private frameworks), so it holds up across Xcode releases.
- Out-of-process coordinate handling so the system share sheet is tappable by ref.
Install
Requires macOS with Xcode. Build from source:
git clone https://github.com/squaduplabs/agent-ios && cd agent-ios
swift build -c releaseSee the README to get started, docs/usage.md for the full command reference, and docs/integrations.md to wire it into Claude Code, Codex, or Cursor. Full notes in the CHANGELOG.