agent-device: mobile iOS & Android automation and development for AI Agents
Automate iOS, Android, TV, macOS, and Linux app QA and development. Agents use token-efficient accessibility snapshots, selectors, interactions, logs, screenshots, video recordings, session replay, can debug and profile apps performance with CPU, memory, and profiler information. Supports React Native
agent-device
Automates Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, extracting UI info, collecting logs/network/perf evidence, or planning agent-device CLI commands.
# agent-device
Router only. Private setup before using this skill:
```bash
agent-device --version
```
Require `agent-device >= 0.14.0`; older CLIs lack these help topics. If older, run `npm install -g agent-device@latest`, recheck, then continue. If you cannot upgrade, stop and tell the user. Do not include version/upgrade commands in final plans.
Before your first agent-device command or plan, read the version-matched CLI guide:
```bash
agent-device help workflow
```
Escalate only when relevant:
```bash
agent-device help debugging
agent-device help react-devtools
agent-device help remote
agent-device help macos
agent-device help dogfood
```
Default loop: `open -> snapshot/-i -> get/is/find or press/fill/scroll/wait -> verify -> close`.
Use this skill only to route into version-matched CLI help. Let `help workflow` provide exact command shapes, platform limits, and current workflow guidance.
For precise location workflows, read the installed `settings` help before planning so coordinate support and platform limits come from the active CLI version.dogfood
Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to dogfood, QA, exploratory test, find issues, bug hunt, or test this app on mobile.
# Dogfood
Router for exploratory QA. Private setup before using this skill:
```bash
agent-device --version
```
Require `agent-device >= 0.14.0`; older CLIs lack these help topics. If older, run `npm install -g agent-device@latest`, recheck, then continue. If you cannot upgrade, stop and tell the user. Do not include version/upgrade commands in final plans.
Read current CLI guidance:
```bash
agent-device help dogfood
```
Loop: open named session -> snapshot -i + screenshot -> explore flows -> capture evidence per issue -> close.
Target app is required; infer platform or ask. Findings must come from runtime behavior, not source reads. Let `help dogfood` provide exact report shape, evidence commands, and current workflow guidance.