agent-device

Automate iOS and Android device interactions via the agent-device CLI.

4.0k|246|Updated Jan 30, 2026

Search Tags:#automation #CLI #mobile #device #snapshot #refs #XCTest

Ready to run

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

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-device
Source: https://github.com/callstackincubator/agent-device/tree/main/skills/agent-device
Command: npx skills add https://github.com/callstackincubator/agent-device --skill agent-device

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automates repetitive mobile UI testing tasks by enabling scripted interactions with iOS and Android apps and simulators through a single CLI.

Core Features & Use Cases

Open apps and boot devices for testing across iOS and Android.
Snapshot UI trees, interact via refs (click, fill, type), and navigate flows.
Extract UI information and perform automated validation during QA.

Quick Start

agent-device open Settings --platform ios agent-device snapshot -i agent-device click @e3 agent-device wait text "Camera" agent-device alert wait 10000 agent-device fill @e5 "test" agent-device close

Frequently Asked Questions about agent-device

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate mobile app interactions for iOS and Android testing?▼

Automating mobile app interactions is done via a CLI that targets iOS and Android simulators and devices for actions like open, snapshot, click, fill, and scroll. It leverages XCTest and AX support to execute backend-driven automation requirements.

Can I capture a UI tree snapshot from an iOS simulator?▼

Yes, you can capture a UI tree snapshot from an iOS simulator. The CLI snapshot command extracts UI information and generates element refs, allowing you to interact with specific UI elements via subsequent commands like click and fill.

Does this CLI tool support both iOS and Android devices?▼

Yes, this CLI supports both iOS and Android platforms. You can specify the platform when opening apps or booting devices, enabling cross-platform automated UI testing and interaction scripting within a single tool.

What is the best way to script repetitive mobile UI testing tasks?▼

The best way to script repetitive mobile UI testing tasks is using a single CLI that handles device booting, app opening, UI tree snapshots, and ref-based interactions. You can chain actions like wait, alert, fill, and close into automated validation flows.

How do I handle alert dialogs during automated device testing?▼

You handle alert dialogs during automated device testing using the CLI alert command. You can specify wait times to ensure alerts are properly managed, allowing your automation script to proceed smoothly through UI flows without interruption.

Why do I need XCTest or AX support for mobile automation?▼

XCTest and AX support are needed for mobile automation because they provide the accessibility hooks required to inspect UI elements, generate accurate refs, and perform reliable interactions like click and fill on iOS and Android apps.