agent-device
Mobile app automation and verification for AI coding agents. CLI, MCP server, and typed Node.js API for iOS, Android, HarmonyOS, TV, web, macOS, and Linux.
Features
- ✓CLI for iOS, Android, tvOS, macOS, AndroidTV UI automation
- ✓Session-based automation for consistent workflows
- ✓Structured snapshots for UI state inspection
- ✓Efficient ref and selector usage for discovery and replay
- ✓Replayable flows for deterministic testing
- ✓Visit GitHub for detailed tool installation guides
Installation Guide
npm install -g agent-deviceagent-device now performs a lightweight background upgrade check for interactive CLI runs and, when a newer package is available, suggests a global reinstall command. Updating the package also refreshes the bundled skills/ shipped with the CLI.
Set AGENT_DEVICE_NO_UPDATE_NOTIFIER=1 to disable the notice.
On macOS, agent-device includes a local agent-device-macos-helper source package that is built on demand for desktop permission checks, alert handling, and helper-backed desktop snapshot surfaces. Release distribution should use a signed/notarized helper build; source checkouts fall back to a local Swift build. Local helper overrides through AGENT_DEVICE_MACOS_HELPER_BIN must use an absolute executable path.