android-emulator
callstack/agent-device
Launch, inspect, and automate testing on Android Emulator with agent-device.
What is android-emulator?
Verify and debug native, React Native, Expo, or Flutter apps running on an Android virtual device. Use this skill when you need to launch an app, inspect its live UI, interact with it (tap, type, scroll), validate code changes, collect failure evidence, or reproduce workflows.
- Launch apps or packages on Android Emulator with foreground focus
- Inspect live UI state and take screenshots
- Interact with the app via tap, type, and scroll commands
- Validate code changes and collect failure evidence
- Debug React Native, Expo, and Flutter applications
- Replay workflows and run tests in CI environments
How to install android-emulator
npx skills add https://github.com/callstack/agent-device --skill android-emulator- agent-device CLI installed globally: npm install -g agent-device@latest
- Android Emulator running or accessible
- Target app installed or available to launch
How to use android-emulator
- 1.Install agent-device globally if not already present
- 2.Ensure Android Emulator is running
- 3.Call agent-device open <app-or-package-id> --platform android --foreground to launch the app
- 4.Follow the interactive snapshot and any corrective error hints
- 5.Use agent-device commands to tap, type, scroll, screenshot, or validate as needed
- 6.Consult help topics (validate, debugging, react-native, react-devtools, scripting) for specialized tasks
Use cases
- Verify a UI change works correctly on Android before merging
- Reproduce a reported bug by automating user interactions
- Validate that a React Native app launches and renders properly
- Collect screenshots and logs when a test fails
- Debug component state and props in a running app
- Mobile app developers (native Android, React Native, Expo, Flutter)
- QA engineers automating app testing
- Agents validating code changes on real virtual devices
- Teams needing visual regression or interaction testing
android-emulator FAQ
No. Start immediately with your app-driving task. Only read help topics if the task is specialized or a command shape is unclear.
Stop and ask the user to install it globally (npm install -g agent-device@latest) or expose their existing installation on PATH.
Yes. This skill supports native Android, React Native, Expo, and Flutter apps. Use 'agent-device help react-native' for runtime-specific guidance.
Use 'agent-device help react-devtools' to access the component tree, props, state, hooks, and render information.
Yes. Use 'agent-device help scripting' for durable replay and CI workflow guidance.
Full instructions (SKILL.md)
Source of truth, from callstack/agent-device.
name: android-emulator description: Verify and debug native, React Native, Expo, or Flutter apps on an Android Emulator with agent-device. Use when an agent needs to launch an app, inspect its live UI, tap, type, scroll, validate a code change, collect failure evidence, or reproduce a workflow on an Android virtual device.
Android Emulator
Require the agent-device CLI to be installed separately before driving an emulator:
npm install -g agent-device@latest
Treat installation and upgrades as user-owned setup steps. Do not run that command autonomously or substitute a mutable npx -y agent-device@latest invocation.
For a normal app-driving task, start immediately. Do not probe first with --help, --version, devices, appstate, snapshot, or screenshot. Target Android explicitly when opening an app or package id:
agent-device open <app-or-package-id> --platform android --foreground
Follow the initial interactive snapshot and corrective error hints. If the shell reports that agent-device is unavailable, stop and ask the user to install it or expose their existing installation on PATH.
Only when the task is specialized or a command shape is unclear, read the relevant version-matched help topic:
agent-device help validate # engineering validation and build freshness
agent-device help debugging # screenshots, logs, traces, video, and failures
agent-device help react-native # React Native and Expo runtime guidance
agent-device help react-devtools # component tree, props/state/hooks, and renders
agent-device help scripting # durable replay and CI workflows
Related skills
More from callstack/agent-device and the wider catalog.
dogfood
Systematically explore and test mobile apps on iOS/Android to find bugs and UX issues.
ios-simulator
Launch, inspect, and automate iOS Simulator testing for native, React Native, Expo, and Flutter apps.
react-devtools
Agent skill from callstack/agent-device.
agent-device
Automate iOS, Android, macOS, tvOS, and Amazon Vega TV apps via CLI commands.
react-native-testing
Write React Native component tests with Testing Library v13/v14 queries, userEvent, and Jest matchers.
agent-device
Automate iOS, tvOS, macOS, and Android device interactions—tap, type, scroll, screenshot, and extract UI data.