agent-device

Installation

Summary

Automate iOS and Android app interactions with snapshot-based discovery and selector-driven replay.

Supports iOS simulators/devices and Android emulators/devices with session-bound automation, multi-tenant remote daemon mode, and device-scope isolation for QA workflows
Core commands: snapshot for UI discovery with refs, press/fill/scroll for interactions, open/close for app lifecycle, install/reinstall for binary deployment
Includes utilities for logging, network inspection, performance metrics, clipboard access, permission management, biometric simulation, and notification delivery
Handles React Native + Metro workflows, tvOS/AndroidTV targeting, batch step execution, and replay maintenance with selector drift detection

SKILL.md

agent-device

Router only. Private setup before using this skill:

agent-device --version

If that fails but the user may have installed agent-device globally, check the user's configured login/interactive shell and environment before using npx. Resolve the command the same way the user would from a normal terminal session, then run the absolute binary path if found. This may require inspecting shell startup behavior or package-manager/global bin locations; do not assume the Codex process PATH is the user's PATH.

Require agent-device >= 0.14.0; older CLIs lack these help topics. If older, stop and tell the user to upgrade the trusted install or approve an exact-version npm command. Do not run npm install -g agent-device@latest or npx -y agent-device@latest autonomously, and do not include version/upgrade commands in final plans.

Before your first agent-device command or plan, read the version-matched CLI guide: