Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Automates interactions for iOS simulators/devices and Android emulators/devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scr...
Automates interactions for iOS simulators/devices and Android emulators/devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scr...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
For exploration, use snapshot refs. For deterministic replay, use selectors.
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.
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 -> logs path -> targeted grep Replay drift: replay -u <path> -> verify updated selectors
agent-device open Settings --platform ios agent-device snapshot -i agent-device press @e3 agent-device diff snapshot -i agent-device fill @e5 "test" agent-device close
agent-device open MyApp --platform ios agent-device logs clear --restart agent-device logs path Logging is off by default. Enable only for debugging windows. logs clear --restart requires an active app session (open <app> first).
agent-device replay -u ./session.ad
agent-device devices agent-device open [app|url] [url] agent-device open [app] --relaunch agent-device close [app] agent-device session list Use boot only as fallback when open cannot find/connect to a ready target.
agent-device snapshot -i agent-device diff snapshot -i agent-device find "Sign In" click agent-device press @e1 agent-device fill @e2 "text" agent-device is visible 'id="anchor"' press is canonical tap command; click is an alias.
agent-device appstate agent-device get text @e1 agent-device screenshot out.png agent-device trace start agent-device trace stop ./trace.log
agent-device batch --steps-file /tmp/batch-steps.json --json
Re-snapshot after UI mutations (navigation/modal/list changes). Prefer snapshot -i; scope/depth only when needed. Use refs for discovery, selectors for replay/assertions. Use fill for clear-then-type semantics; use type for focused append typing. iOS appstate is session-scoped; Android appstate is live foreground state. iOS settings helpers are simulator-only; use faceid match|nonmatch|enroll|unenroll. If using --save-script, prefer explicit path syntax (--save-script=flow.ad or ./flow.ad).
Prefer a preinstalled agent-device binary over on-demand package execution. If install is required, pin an exact version (for example: npx --yes agent-device@<exact-version> --help). Signing/provisioning environment variables are optional, sensitive, and only for iOS physical-device setup. Logs/artifacts are written under ~/.agent-device; replay scripts write to explicit paths you provide. Keep logging off unless debugging and use least-privilege/isolated environments for autonomous runs.
Mixing debug flow into normal runs (keep logs off unless debugging). Continuing to use stale refs after screen transitions. Using URL opens with Android --activity (unsupported combination). Treating boot as default first step instead of fallback.
references/snapshot-refs.md references/logs-and-debug.md references/session-management.md references/permissions.md references/video-recording.md references/coordinate-system.md references/batching.md
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.