software-mansion/argent

argent-android-emulator-setup

Set up and connect to an Android emulator using argent MCP tools.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/software-mansion/argent --skill argent-android-emulator-setup

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

1. Prerequisites

The Android SDK (platform tools and emulator) and an AVD, created in Android Studio or with avdmanager create avd. If list-devices returns no Android devices and no avds, either no AVD exists or Argent can't find the SDK. Then run argent config set android.sdkRoot <sdk-path> and call list-devices again after a minute: a failed SDK lookup is cached that long. Exporting ANDROID_HOME in your shell doesn't reach the tool-server that is already running.

2. Setup

  1. Find a ready device: call list-devices. Filter for entries with platform: "android". Ready devices (state: "device") come first. If the user named a device, use it. Otherwise pick the first kind: "emulator" that fits the task. Take a physical phone (kind: "device") only when the user asks for one. If the result has a hint about the adb server, prefix every adb command that you run yourself, as the hint shows.
  2. Boot if needed: if no such emulator is ready, call boot-device with avdName: <name> from the same call's avds list. avds doesn't mark TV images: for a TV task, pick the AVD by its name.

3. Using the device

Pass the Android serial as udid to the same interaction tools as on iOS. See argent-device-interact for interaction tooling and the Android notes at the bottom of that skill. If a React Native app can't reach Metro, see argent-metro-debugger §1.

4. Notes

  • Android TV / leanback AVDs boot through this exact flow, but list-devices tags them runtimeKind: "tv" and they are focus-driven: use the argent-tv-interact skill, not the gesture tools.
  • To stop the emulator, run adb -s <serial> emu kill from a shell (clean shutdown). Never pkill -9/kill -9 qemu: a hard kill leaves the userdata image dirty, after which cold boots can hang for many minutes doing recovery (runaway writes, boot_completed never flips). If an image gets into that state, boot once with -wipe-data to reset it.
from this repository

More skills

All skills
software-mansion
Community

argent-create-e2e

Create, record, edit, replay, or repair reusable Argent e2e test YAML files. Use when the user asks to record, replay, or run an e2e test or a repeatable device path, set up profiling or an A/B comparison, or invoke the authoring engine behind argent-qa-e2e. Also use before repeating three or more interactions. For one-off UI checks, acceptance-driven regression tests, or screen video, use argent-test-ui-flow, argent-qa-e2e, or argent-screen-recording respectively.

1h installs
6
GitHub stars
3.2K
Updated
Nov 19
software-mansion
Community

argent-device-interact

Interact with an iOS simulator or iPhone, Android emulator or phone, or Chromium (CDP) app using argent MCP tools. Use when tapping UI elements, performing gestures, scrolling/swiping, typing text, pressing hardware buttons, launching apps, opening URLs, taking screenshots, waiting for an element to appear or disappear, or checking visible app state after interactions. Not for TV targets.

1h installs
6
GitHub stars
3.2K
Updated
Nov 19
software-mansion
Community

argent-ios-device-interact

Drive a physical iPhone through argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator. For cable, trust, or signing problems read argent-ios-device-setup.

1h installs
6
GitHub stars
3.2K
Updated
Nov 19
software-mansion
Community

argent-ios-device-setup

Set up a cabled physical iPhone for argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator.

1h installs
6
GitHub stars
3.2K
Updated
Nov 19