agent-device
Automates interactions for iOS simulators/devices and Android emulators/devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info on mobile targets.
Best for mobile QA engineersWorks with GitHubLow risk
⌘source
- author
@gronxb- language
- TypeScript
★1.4kstars
140forks
May 7, 2026
✦overview.md
Key Features
- ·Automate iOS simulators and Android emulators
- ·Navigate apps, tap, type, scroll
- ·Take snapshots and extract UI info
- ·Support selective debugging and crash reproduction
- ·Enable isolated device scoping
Use Cases
- →Automate repeated UI interactions during exploratory testing
- →Take screenshots for visual regression
- →Debug crashes by reproducing, capturing logs, and network dumps
- →Replay recorded interactions after app updates
Best for
- ✓mobile QA engineers
- ✓UI automation pipelines
Not ideal for
- !one-off manual tests
- !backend-only testing
FAQs
name
agent-device
description
Automates interactions for iOS simulators/devices and Android emulators/devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info on mobile targets.
Mobile Automation with agent-device
For exploration, use snapshot refs. For deterministic replay, use selectors. For structured exploratory QA bug hunts and reporting, use ../dogfood/SKILL.md.
Start Here (Read This First)
Use this skill as a router, not a full manual.
- Pick one mode:
- Normal interaction flow
- Debug/crash flow
- Replay maintenance flow
- Run one canonical flow below.
- Open references only if blocked.
Decision Map
- No target context yet:
devices-> pick target ->open. - Normal UI task:
open->snapshot -i->press/fill->diff snapshot -i->close - Debug/crash:
open <app>->logs clear --restart-> reproduce ->network dump->logs path-> targetedgrep - Replay drift:
replay -u <path>-> verify updated selectors - Remote multi-tenant run: allocate lease -> point client at remote daemon base URL -> run commands with tenant isolation flags -> heartbeat/release lease
- Device-scope isolation run: set iOS simulator set / Android allowlist -> run selectors within scope only
Target Selection Rules
- iOS local QA: use simulators unless the task explicitly requires a physical device.
$install
1-click copynpx skills add gronxb/hot-updater --skill agent-deviceSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
3/ 5
goodMostly clear, but there are still a few confusing or poorly structured parts.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.