AppCrawl

AI-powered app testing. Let an LLM explore your mobile or web app, find bugs, and generate replayable tests. Bring your own API key.

---

What it does

# Let AI explore your app autonomously
appcrawl explore --app com.example.app

# Or steer it with natural language
appcrawl run "sign up, verify email, reach dashboard"

# Extract explore sessions to replayable YAML suites
appcrawl extract --from appcrawl-reports/latest

# Run suites in CI with parallel execution
appcrawl suite tests/ --parallel 4 --notify-slack $SLACK_WEBHOOK

AppCrawl runs an LLM agent (Claude, GPT-4o, Gemini, Ollama, ...) against your iOS simulator, Android emulator, or a Playwright-driven browser. The agent sees screenshots + the accessibility tree, picks actions (tap, type, scroll, verify), and logs anything that looks wrong.

Features

• Mobile + web — iOS via Maestro, Android via adb, web via Playwright
• BYO LLM — Claude / GPT-4o / Gemini / Ollama / OpenRouter
• Explore mode — autonomous bug-hunting with breadth-first screen coverage
• Steered mode — natural-language E2E tests, no selectors
• Suite runner — YAML-defined tests, parallel execution
• Test extraction — convert explore sessions to replayable suites
• Visual regression — pixel-diff screenshots against baselines
• GitHub Action — drop-in composite action with PR comments
• Static HTML dashboard — deploy reports to any static host
• Slack + webhook notifications — know the moment something breaks

Install

npm install -g appcrawl

Requires Node 20+. For iOS testing also install Maestro; for web testing run npx playwright install chromium.

Quick start

1. Set your LLM key:

   export ANTHROPIC_API_KEY=sk-ant-...   # or OPENAI_API_KEY / GOOGLE_GENERATIVE_AI_API_KEY

2. Verify setup:

   appcrawl doctor

3. Explore:

   # iOS
   appcrawl explore --app com.example.app --max-steps 20
   
   # Web
   appcrawl explore --url https://example.com --platform web --max-steps 20

4. Open the generated HTML report from appcrawl-reports/.

Pricing

• Free — 5 explore runs / day, console output, single LLM provider
• Pro ($79/yr) — unlimited runs, steered testing, HTML/JSON reports, visual regression, CI mode, Slack notifications, parallel suites

Buy at appcrawl.dev · License key is offline-validated.

Docs

• Website
• GitHub Action example
• Config reference

License

MIT — see LICENSE.