agent-device
自動化 iOS 與 Android 應用程式互動,支援基於快照的 UI 探索與選擇器驅動的回放。適用於 iOS 模擬器/裝置及 Android 模擬器/裝置,提供會話綁定自動化、多租戶遠端守護程式模式,以及裝置層級隔離以支援 QA 工作流程。核心指令包括:用於 UI 探索的 snapshot(附參考標記)、用於互動的 press / fill / scroll、用於應用程式生命週期的 open / close、用於二進位部署的 install / reinstall。包含日誌記錄、網路檢測等工具。
npx skills add https://github.com/callstackincubator/agent-device --skill agent-deviceagent-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.