Agent Device

Name: Agent Device
Author: callstackincubator

callstackincubator/agent-device

8.3k installs
3.7k repo stars
Updated July 27, 2026
callstackincubator/agent-device

agent-device is an agent skill that routes mobile automation through the agent-device CLI with version-matched help for iOS, Android, and Apple platforms.

About

This skill routes agents into the version-matched agent-device CLI for Apple-platform and Android device automation. It covers the default workflow loop of open, snapshot, interact, verify, and close, plus escalation topics for debugging, React Native, React DevTools, CDP, remote devices, macOS, and dogfood testing. Before planning commands, verify agent-device is at least version 0.14.0 and read the installed help workflow output so command shapes and platform limits come from the active CLI rather than stale assumptions. The skill resolves PATH mismatches between the agent process and the user shell, refuses autonomous global npm upgrades, and escalates to debugging or CDP help only when the task requires it. Use it when navigating apps, capturing screenshots, extracting UI structure, collecting logs or network evidence, or planning reliable mobile test automation without guessing CLI syntax.

Requires agent-device 0.14.0+ and reads version-matched help workflow before planning
Default loop: open, snapshot, get or find, press or fill, verify, then close
Escalates to debugging, React Native, CDP, remote, macOS, and dogfood help topics
Resolves CLI path from the user shell instead of assuming the agent process PATH
Blocks autonomous npm install or npx upgrade commands without explicit user approval

Agent Device by the numbers

8,340 all-time installs (skills.sh)
+426 installs in the week ending Jul 28, 2026 (Skillselion tracking)
Ranked #18 of 1,048 Mobile Development skills by installs in the Skillselion catalog
Security screen: HIGH risk (skills.sh audit)
Data as of Jul 28, 2026 (Skillselion catalog sync)

At a glance

agent-device capabilities & compatibility

Capabilities: verify agent device cli version meets 0.14.0 · read version matched help workflow · route into debugging react native cdp help topic · follow open snapshot interact verify close loop
Use cases: testing · debugging

npx skills add https://github.com/callstackincubator/agent-device --skill agent-device

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/callstackincubator/agent-device.svg)](https://skillselion.com/skills/callstackincubator/agent-device)

Installs	8.3k
repo stars	★ 3.7k
Security audit	3 / 3 scanners passed
Last updated	July 27, 2026
Repository	callstackincubator/agent-device ↗

How do I plan reliable agent-device CLI commands without guessing syntax or using outdated CLI versions?

Automate iOS, tvOS, macOS, and Android apps via agent-device CLI for navigation, snapshots, taps, typing, logs, and performance evidence.

Who is it for?

Mobile QA engineers and agents automating taps, snapshots, and log collection on Apple or Android devices.

Skip if: Pure web browser automation without device targets or teams without agent-device installed.

When should I use this skill?

Before the first agent-device command or when navigating apps, taking snapshots, or collecting mobile debug evidence.

What you get

Version-verified agent-device command plan following open-snapshot-interact-verify-close with correct help topic escalation.

device screenshots
UI snapshots
log and network evidence

Files

SKILL.mdMarkdownGitHub ↗

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:

agent-device help workflow

Escalate only when relevant:

agent-device help debugging
agent-device help react-native
agent-device help react-devtools
agent-device help cdp
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.