Skip to main content
FinalRun is an AI-driven testing CLI that runs your Android and iOS apps through real user scenarios — written in plain English, executed by AI on a real device or emulator. You describe what to test in a YAML file; FinalRun taps, swipes, types, and verifies on your behalf, then produces a pass/fail report with video, screenshots, and device logs.

Quick Start

Install FinalRun and run your first test in minutes.

Write Tests

Learn the YAML test format for natural-language mobile testing.

CLI Reference

Every command, flag, and option available in the finalrun CLI.

AI Agent Skills

Use AI coding agents to generate, run, and fix tests automatically.

​
How FinalRun works

FinalRun connects an AI model to a real device or emulator. You write a test spec describing what a user would do; the AI reads the screen, performs each action, and checks the result.
1

Install the CLI

Run the one-line install script to get FinalRun, Node.js, and all platform tools set up.
curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bash
2

Add your AI key

FinalRun uses your own AI provider key (Google, OpenAI, or Anthropic) — no account signup needed.
echo "GOOGLE_API_KEY=your-key-here" > .env
3

Write a test

Create a YAML file in .finalrun/tests/ describing steps in plain English.
name: login_smoke
steps:
  - Launch the app.
  - Enter ${secrets.email} on the login screen.
  - Tap the Login button.
expected_state:
  - The home screen is visible.
4

Run it

Execute the test on Android or iOS with a single command.
finalrun test login_smoke.yaml --platform android --model google/gemini-3-flash-preview

Configuration

Set up your workspace config, app identity, and environments.

Troubleshooting

Fix common errors and verify host readiness with finalrun doctor.