agenTest

# AgenTest

AI-driven mobile app testing via MCP. Any AI coding agent can test any Android app.

Your AI reads your code, generates test cases, and executes them against a real emulator -- no test framework, no boilerplate, no `testID`s required.

**Works with:** Claude Code, Cursor, Windsurf, Cursor, Kiro, Antigravity, and any MCP-compatible agent.

## How is AgenTest different from Appium or Maestro?

Appium and Maestro are excellent test frameworks. If you have a QA team writing and maintaining structured test suites, they're the right tools. AgenTest solves a different problem.

**AgenTest is for developers who don't write tests.** If you're building with Cursor, Bolt, v0, or Lovable -- shipping fast, iterating daily, no QA team -- you probably have zero test coverage. AgenTest lets your AI agent test your app with a single prompt. No test code, no YAML, no page objects.

### Where AgenTest shines

- **Zero setup overhead.** `npm install -g agentest` + 4 lines of JSON. No Java, no Selenium, no drivers.
- **No testIDs required.** Most AI-generated apps don't have `testID`s. AgenTest auto-generates `@ref` selectors and extracts React component names from the Hermes runtime -- icon buttons like `<Phone />` and `<Microphone />` just work.
- **No test maintenance.** The AI sees the current UI tree and adapts. No selectors to update, no flows to rewrite when the UI changes.
- **Source code awareness.** When a test fails, the AI reads your code to explain *why* -- not just which assertion broke.
- **Fast.** ~150-400ms per action with the on-device helper + gRPC, comparable to Maestro, faster than Appium.

### Where Appium and Maestro are better

- **Deterministic CI suites.** If you need the same test to run identically 1000 times, a hand-written Appium/Maestro test is more predictable than an AI-generated one.
- **Cross-platform parity.** Appium supports iOS, Android, web, and desktop today. Maestro supports iOS and Android. AgenTest is Android-only (iOS coming soon)