agent-device
Tự động hóa tương tác ứng dụng iOS và Android với khám phá dựa trên ảnh chụp nhanh và phát lại dựa trên bộ chọn. Hỗ trợ trình mô phỏng/thiết bị iOS và trình giả lập/thiết bị Android với tự động hóa theo phiên, chế độ daemon từ xa đa người thuê và cách ly phạm vi thiết bị cho quy trình QA. Các lệnh cốt lõi: snapshot để khám phá UI với tham chiếu, press / fill / scroll để tương tác, open / close cho vòng đời ứng dụng, install / reinstall để triển khai nhị phân. Bao gồm các tiện ích cho ghi nhật ký, kiểm tra mạng,...
npx skills add https://github.com/callstackincubator/agent-device --skill agent-deviceagent-device
For a normal app-driving task, start immediately. Do not probe first with --help, --version, devices, appstate, snapshot, or screenshot:
agent-device open <app> --foreground
That starts the session and returns the initial interactive snapshot with @refs.
Loop: act with press|click|fill|longpress <target> ... --settle, scroll <direction> --settle, or back --settle; continue from the printed diff, verify the named expectation (wait text "...", is, get, or find), then run agent-device close.
Copy refs byte-for-byte: @e12, @e12~s4 — keep the @ and any ~sN. Prefer current refs, then id/label/role selectors; coordinates are a last resort. If snapshot reports sparse/AX-unavailable, its refs and selectors are invalid: run agent-device screenshot, inspect the image, use coordinates, then retry snapshot -i after navigating. Otherwise run snapshot -i only when the diff lacks the next target.
Error output includes corrective hints; follow them instead of re-planning. Only when the task is specialized (for example gestures, scripting, TV, macOS, remote, or debugging) or a command shape is unclear, run agent-device help <topic>. agent-device --help lists topics, but is not a startup step.