FinalRun is an open-source, CLI-based tool. You can run it with your own AI provider key (BYOK), or sign up for FinalRun Cloud for managed AI without provisioning a provider account. The questions below cover the most common things people ask.Documentation Index
Fetch the complete documentation index at: https://docs.finalrun.app/llms.txt
Use this file to discover all available pages before exploring further.
Do I need to create a FinalRun account?
Do I need to create a FinalRun account?
Only if you want to use FinalRun Cloud for managed AI. Cloud accounts are free to create and include $5 of credits — sign up at cloud.finalrun.app and set
FINALRUN_API_KEY. See Cloud API Key.If you’d rather bring your own AI provider key (Google, OpenAI, or Anthropic), no FinalRun account is needed — install the CLI, set the provider key, and run. See AI Providers.What's the difference between BYOK and FinalRun Cloud?
What's the difference between BYOK and FinalRun Cloud?
Both run the same CLI and produce the same test artifacts. They differ in how AI access is provisioned and billed:
Cloud is the fastest way to get started. BYOK is useful if your team already has a provider account, wants a specific model tier, or needs provider-side billing visibility.
| FinalRun Cloud | BYOK | |
|---|---|---|
| Account needed | FinalRun account at cloud.finalrun.app | None for FinalRun; you supply a Google/OpenAI/Anthropic key |
| Env variable | FINALRUN_API_KEY | GOOGLE_API_KEY / OPENAI_API_KEY / ANTHROPIC_API_KEY |
| Billing | $5 free credits, then per-run via FinalRun | Standard provider API rates, billed by Google/OpenAI/Anthropic |
| Provider account | Not required | Required (one of the three above) |
Which AI providers does FinalRun support?
Which AI providers does FinalRun support?
Three AI providers are supported when bringing your own key:
Costs are billed directly by your provider at standard API rates. Set the key in your shell, in a
| Provider | Supported models | Environment variable |
|---|---|---|
| Gemini 3+ | GOOGLE_API_KEY | |
| OpenAI | GPT-5+ | OPENAI_API_KEY |
| Anthropic | Claude Sonnet 4 / Opus 4+ | ANTHROPIC_API_KEY |
.env file at your workspace root, or pass --api-key for a single run.Prefer not to provision a provider account? Use FinalRun Cloud instead — set FINALRUN_API_KEY and you’re done.Does FinalRun work with real devices or only emulators?
Does FinalRun work with real devices or only emulators?
- Android — both real devices (over
adb) and emulators are supported. - iOS — simulators only today. Physical iOS device support is on the roadmap; join the waitlist for early access.
Which platforms does FinalRun support?
Which platforms does FinalRun support?
Android and iOS.
How much does each test run cost?
How much does each test run cost?
FinalRun the CLI is free and open-source. AI execution is billed in one of two ways:
- FinalRun Cloud — new accounts include $5 of free credits. After that, runs are billed per execution. Sign up at cloud.finalrun.app.
- BYOK — you pay your AI provider (Google, OpenAI, or Anthropic) directly for tokens consumed during test execution. Cost depends on the model you choose and how long the test takes. FinalRun adds no markup.
Can I run FinalRun in CI/CD?
Can I run FinalRun in CI/CD?
Yes — only on FinalRun Cloud. Set Local emulator/simulator runs aren’t supported in CI today.
FINALRUN_API_KEY as a CI secret and call finalrun cloud test as a pipeline step:How do I use FinalRun with AI coding agents like Claude Code, Cursor, or Codex?
How do I use FinalRun with AI coding agents like Claude Code, Cursor, or Codex?
FinalRun ships a set of agent skills that let you generate tests, run them, and fix failures — all from your AI coding agent chat. They work in Claude Code, Cursor, and Codex (and any other agent that supports the skills protocol).The FinalRun installer registers the skills globally. To install or update them manually:Three slash commands are then available:
See AI Agent Skills for details.
| Command | What it does |
|---|---|
/finalrun-generate-test | Reads your source code, infers app identity, and generates complete YAML test specs |
/finalrun-use-cli | Validates and runs your tests using the CLI |
/finalrun-test-and-fix | Runs the full generate → run → diagnose → fix loop until the test is green |
Where are test artifacts stored?
Where are test artifacts stored?
Artifacts for each run — including video, screenshots, and device logs — are stored at:Use
finalrun runs to list all recorded runs for your current workspace, and finalrun start-server to open the visual report UI where you can browse results interactively.