FinalRun: AI-powered Android and iOS test automation

FinalRun lets you write plain-English test specs in YAML and run them on Android and iOS using AI models like Gemini, GPT, or Claude.

FinalRun is an AI-powered CLI for testing Android and iOS apps with natural language. You write test scenarios in YAML, describing actions the way a person would. FinalRun launches your app on a real device or emulator and uses an AI model to see the screen and perform each action — tapping, swiping, typing, and verifying results. When the run finishes, you get a pass/fail report complete with video, screenshots, and device logs.

Get started

Installation

Prerequisites, install the CLI, and verify host readiness.

Quickstart

Write and run your first test in minutes.

YAML test format

Learn the full test spec format: fields, placeholders, and suites.

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.

Configuration

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