finalrun.app • Blog • Cloud Device Waitlist • Join Slack Community
finalrun-agent is an AI-driven CLI that tests your Android and iOS apps using natural language. You write a plain-English test in YAML, FinalRun launches your app on an emulator or simulator, uses an AI model (Gemini, GPT, or Claude) to see the screen and perform each step — tapping, swiping, typing — and produces a pass/fail report with video and device logs.
curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bashSets up Node.js, the CLI, AI coding agent skills, and platform tools. Run finalrun doctor to verify host readiness.
FinalRun ships skills that let your AI coding agent generate tests, validate workspaces, and run tests — all from chat.
This skill reads your app's source code, infers the app identity, and generates complete test specs with setup, steps, and expected state — organized by feature folder.
/finalrun-generate-testGenerate tests for the authentication feature — cover login with valid credentials, login with wrong password, and logout
The agent will:
- Read your source code to understand the UI and infer the app's package name / bundle ID
- Set up
.finalrun/config.yamland environment bindings in.finalrun/env/ - Propose a test plan with file paths and cleanup strategy for your approval
- Generate YAML specs under
.finalrun/tests/auth/and a suite under.finalrun/suites/ - Run
finalrun checkto validate everything
/finalrun-generate-testAdd a smoke test that verifies the app launches and the home screen is visible
Once your tests are generated, use this skill to validate and run them.
/finalrun-use-cliRun the auth tests on Android
FinalRun uses your own AI provider API key to run tests.
echo "GOOGLE_API_KEY=your-key-here" > .env| Provider | Environment variable |
|---|---|
google/... |
GOOGLE_API_KEY |
openai/... |
OPENAI_API_KEY |
anthropic/... |
ANTHROPIC_API_KEY |
Test runs consume API tokens from your configured provider — standard API billing applies.
finalrun test smoke.yaml --platform android --model google/gemini-3-flash-previewfinalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-preview- YAML Tests — test format, fields, suites, and environment placeholders
- CLI Reference — all commands, flags, and report tools
- Configuration — workspace config, app identity,
--appflag, and per-environment overrides - Environment & Secrets — dotenv load order, provider keys, and platform prerequisites
- Troubleshooting — common errors and fixes
See CONTRIBUTING.md for monorepo structure, build commands, and contributor guidelines.