mobile-agent-testers

agent
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

20 AI testers on 20 different phones, in parallel, for $0: Claude Code agents on iOS Simulators and Android emulators via GitHub Actions

README.md

mobile-agent-testers

20 AI testers on 20 different phones, in parallel, for $0.

Each tester is a Claude Code agent with its own iOS Simulator or Android
emulator on GitHub Actions. It plays a persona, uses your app like a new user
and writes a bug report with screenshots. Flutter, React Native, Expo, native
Kotlin and Swift, Kotlin Multiplatform, Capacitor and .NET MAUI.

Real screen recordings of four AI testers using the demo app at the same time (small Android phone, Pixel 7 in dark mode, iPhone SE in French, iPad with the largest text), with each bug they find shown under its phone

Stars
License: MIT
iOS + Android
Claude Code plugin
Last commit

Quick start

gh repo create my-testers --public --template pierridotite/mobile-agent-testers --clone
cd my-testers && ./setup.sh           # key pair + secrets + Claude token (Windows: .\setup.ps1)
gh workflow run agent-testers.yml     # demo: 2 Android + 2 iOS testers, ~20 min
bash scripts/collect.sh <run id>      # decrypts reports into runs/<id>/SUMMARY.md

The demo app has 11 deliberate bugs. On the recorded run above, the 4 demo testers found 9 of them (2 to 7 minutes per agent, about 21 minutes for the whole run, builds included), plus real issues nobody planted (a button under the Android nav bar, no data kept after a relaunch). Model usage: $0.87 for the 4.

Or let Claude set it up for your app:

/plugin marketplace add pierridotite/mobile-agent-testers
/plugin install mobile-agent-testers@mobile-agent-testers

Test your own app

gh workflow run agent-testers.yml -f source_repo=you/app -f app_id=com.you.app \
  -f android_personas=anna,malik -f ios_personas=clara,jonas
Input
source_repo, ref App repo and branch (empty = this repo). Private repo: add a read-only SOURCE_REPO_TOKEN secret
app_dir, app_id App folder, Android package / iOS bundle id (if the other platform uses another id, it is read from its built app)
android_personas, ios_personas Ids from personas.json, one phone each
brief Agent instructions (AGENT_BRIEF.md)
framework auto (default) or force one of the frameworks below
android_build + apk_path, ios_build + ios_app_path Your own build command, or a download of a prebuilt app (paths relative to app_dir)
block_hosts Analytics hosts blocked during tests
record_video Screen recording of each phone, encrypted with the reports

Supported out of the box (detected automatically):

Framework Android iOS Simulator
Flutter flutter build apk flutter build ios --simulator
React Native / Expo Gradle release Xcode, arm64
Native Kotlin / Java, Swift / Objective-C Gradle debug Xcode, arm64
Kotlin Multiplatform Gradle debug Xcode project of the iOS app
Capacitor / Ionic Gradle debug after cap sync Xcode after cap sync
.NET MAUI (beta) dotnet publish dotnet build for iossimulator-arm64
Anything else android_build + apk_path ios_build + ios_app_path

Agents read the screen from screenshots and the accessibility tree, so any UI
toolkit works. Labelled widgets (Flutter Semantics, contentDescription,
accessibilityLabel) give them more precise tap targets.

How it works

How it works: one workflow builds the app, then one emulator or simulator with one agent per persona, encrypted reports, summary on your machine

  • Personas set the device: model, OS, font size, dark mode, language, location.
  • Three tools per agent: see the screen (with tap coordinates), gestures, typing.
  • Encrypted results: public repo logs are public, so everything is encrypted with your key.
  • Analytics blocked inside the phones, so tests never touch your real stats.

Limits

  • GitHub runners are free for public repos: about 20 jobs at once, 5 on macOS.
  • 20 agents can use a Claude subscription's 5-hour window in ~15 min: run batches of 6-10.
  • Hosted runners are meant for the repo's own project. For a closed-source app, run the workflow in your private repo or on your own Mac.

Star history

Star History Chart

Credits

Claude Code ·
AXe ·
android-emulator-runner

Made by @pierridotite (LinkedIn) · MIT license

Reviews (0)

No results found