android-emulator / skill
v0.4.0 · Plugin macOS · Linux · Windows

Build, test, and automate Android apps with Claude Code.

A production-ready skill of 29 scripts wrapping adb, uiautomator, avdmanager, and the Gradle wrapper with semantic interfaces designed for AI agents and developers.

Install Browse the scripts
/01
29
Production scripts
/02
96%
Token reduction vs raw tools
/03
3
OS: macOS · Linux · Windows
01 / WHY

Why it matters.

Principles applied to every script.

A

Token-efficient by default

Default output is a few lines. Drill into errors, warnings, or full logs only when you need them with --verbose and --json. About 96% less output than raw tools.

B

Semantic UI navigation

Find elements by meaning — text, type, or resource ID — not pixel coordinates. Built on the uiautomator hierarchy, so tests survive UI redesigns.

C

Emulators and real devices

Everything runs through adb, so the same scripts drive emulators and physical devices. Multiple emulators are supported with batch operations and --serial targeting.

D

Production-ready

Class-based scripts, modern type hints, Black + Ruff CI, and a mocked pytest suite. Auto device detection. Idempotent emulator lifecycle (create / boot / shutdown / erase / delete).

02 / CATALOG

29 scripts. 8 categories.

Every script supports --help and --json, and auto-detects the connected device unless you pass --serial.

/A

App Management

  • app_launcher.pyLaunch, terminate, install/uninstall APKs, deep links, list packages, app state. --launch · --terminate · --install · --uninstall · --open-url · --list · --state
/B

Device Lifecycle

  • emulator_boot.pyBoot AVDs with optional readiness wait and headless mode. --avd · --wait-ready · --timeout · --headless · --list-avds
  • emulator_shutdown.pyGracefully shut down emulators, with verification and batch support. --serial · --verify · --timeout · --all
  • emulator_create.pyCreate AVDs by device type and API level. --device · --api · --name · --abi · --variant · --list-devices · --list-images
  • emulator_delete.pyDelete AVDs permanently. --name · --list
  • emulator_erase.pyFactory-reset an AVD, wiping user data without deleting it. --name · --force · --list
/C

Build & Development

  • build_and_test.pyGradle build/test with progressive disclosure; parses JUnit XML and Gradle/Kotlin/Java errors. --project · --module/-p · --variant · --clean · --test · --suite · --get-errors · --get-warnings · --get-log · --list-builds
  • log_monitor.pyReal-time logcat with package and severity filtering, dedup, and save-to-file. --app · --serial · --severity · --follow · --duration · --output · --clear
/D

Navigation & Interaction

  • screen_mapper.pyAnalyze the current screen and list interactive elements by type. --serial · --list · --verbose
  • navigator.pyFind and interact with elements semantically (text, type, resource ID). --find-text · --find-type · --find-id · --tap · --enter-text · --list
  • gesture.pySwipes, scrolls, and long press, including edge swipes. --swipe · --from-edge · --duration · --long-press · --scroll
  • keyboard.pyType text, press hardware keys/buttons, clear input. --text · --key · --button · --clear
/E

Testing & Analysis

  • accessibility_audit.pyWCAG checks: content descriptions, touch-target size, EditText hints, image accessibility. --serial · --output · --verbose
  • visual_diff.pyCompare two screenshots and generate a diff image. --image1 · --image2 · --output · --threshold
  • test_recorder.pyDocument test execution with screenshots and UI hierarchy per step. --test-name · --output · --serial · --inline · --size · --app-name
  • app_state_capture.pyAll-in-one debugging snapshot: screenshot, UI hierarchy, logs, app info. --package · --output · --serial · --logs/--no-logs · --screenshot-size
/F

Permissions & Environment Control

  • privacy_manager.pyGrant/revoke runtime permissions (20+ types), with batch support. --grant · --revoke · --list · --package · --list-permissions
  • status_bar.pyDemo-mode status bar: battery, charging, WiFi/mobile signal, time. --battery · --charging · --wifi · --mobile · --time · --reset
  • push_notification.pySend test notifications and list channels. --package · --title · --message · --id · --data · --list-channels · --method
  • appearance.pyDark/light mode and font scale, best-effort locale. --theme · --text-size · --font-scale · --locale · --reset
  • location.pySimulate GPS via adb emu geo fix: fixed coords, city presets, GPX route replay (emulator only). --lat/--lng · --city · --gpx · --interval/--speed · --clear · --list-cities
/G

Discovery & Device State

  • android_health_check.shVerify the environment (ANDROID_HOME, adb, emulator, avdmanager, sdkmanager, java, Python, Pillow) and list devices/AVDs.
  • device_list.pyList connected devices and defined AVDs with progressive disclosure. --get-details · --device-type/--name
  • emulator_selector.pySuggest the best AVD (running → recent → latest API → common models); list or boot one. --suggest · --list · --boot · --headless · --count
  • localization_audit.pyAudit res/values*/strings.xml for missing keys per locale and placeholder mismatches. --res · --source · --locale · --strict
/H

Inspection & Stability

  • container.pyInspect a debuggable app's sandbox via adb shell run-as: files, shared_prefs, SQLite schema, snapshot export. --package · --ls · --cat · --shared-prefs · --databases · --export
  • model_inspector.pyInspect Room annotations, exported-schema JSON, and live SQLite schema (Room == SQLite). --source · --schema · --show-versions · --raw · --package · --db
  • anr_watcher.pyRecord & summarise ANRs/jank from logcat with session-based progressive disclosure. --start · --stop · --get-details · --list-sessions · --diff · --watch · --since · --terse

Three shared modules back the scripts above — common/device_utils.py (ADB command building & device detection), common/screenshot_utils.py (capture & resize), and common/cache_utils.py (progressive-disclosure cache). The Gradle build system lives in the gradle/ subpackage.

03 / INSTALL

Install as a Claude Code plugin.

Two commands. Restart Claude Code and the skill loads automatically.

claude-code 
/plugin marketplace add fluxxion82/android-emulator-skill
/plugin install android-emulator-skill@fluxxion82

Prerequisites: Android SDK with platform-tools & emulator · Python 3.8+ · ADB · Gradle (optional) · Pillow for screenshot resizing (optional).

04 / QUICK START

A typical flow.

Launch, map the screen, interact, and audit — all semantic, all token-light.

manual testing flow 
python scripts/app_launcher.py --launch com.example.app
python scripts/screen_mapper.py
python scripts/navigator.py --find-text "Login" --tap
python scripts/navigator.py --find-type EditText --enter-text "user@example.com"
python scripts/accessibility_audit.py