# FinalRun

## Docs

- [Connect FinalRun to Google, OpenAI, or Anthropic AI](https://docs.finalrun.app/configuration/ai-providers.md): Bring your own API key to FinalRun and configure Google Gemini, OpenAI GPT, or Anthropic Claude as the AI model that drives your Android and iOS test runs.
- [Get your FinalRun Cloud API key](https://docs.finalrun.app/configuration/cloud-api-key.md): Sign up for FinalRun Cloud, generate an API key, and set FINALRUN_API_KEY for the CLI.
- [FinalRun environments: secrets, variables, and overrides](https://docs.finalrun.app/configuration/environments.md): Use named environment files and dotenv files to manage variable bindings, secret placeholders, and per-environment app identity overrides in FinalRun.
- [FinalRun workspace config: app identity and defaults](https://docs.finalrun.app/configuration/workspace.md): Set up .finalrun/config.yaml with app identity, default environment, and AI model fields to configure your FinalRun workspace for Android and iOS testing.
- [FinalRun FAQ: accounts, AI providers, pricing, and CI/CD](https://docs.finalrun.app/faq.md): Answers to common FinalRun questions: BYOK vs FinalRun Cloud, supported AI providers, platform compatibility, CI/CD usage, and artifact storage.
- [FinalRun: AI-powered Android and iOS test automation](https://docs.finalrun.app/index.md): Let Claude Code, Cursor, or Codex write, run, and fix Android and iOS tests for you in plain English.
- [Install FinalRun on macOS, Linux, or Windows](https://docs.finalrun.app/installation.md): Run the one-line installer for your OS and verify your host with finalrun doctor.
- [Quickstart: write your first FinalRun test from your AI coding agent](https://docs.finalrun.app/quickstart.md): Use FinalRun's AI agent skills inside Claude Code, Cursor, or Codex to write, run, and fix mobile tests for your app — no manual YAML required.
- [FinalRun AI agent skills: generate, run, and fix tests](https://docs.finalrun.app/running/ai-agent-skills.md): Install and use FinalRun's three AI agent skills — generate-test, use-cli, and test-and-fix — to automate mobile test creation, execution, and debugging.
- [FinalRun CLI reference: all commands, flags, and options](https://docs.finalrun.app/running/cli-reference.md): Complete reference for all FinalRun CLI commands — test, suite, check, doctor, runs, and server commands — with flags and copy-paste usage examples.
- [FinalRun test reports: browse artifacts, video, and logs](https://docs.finalrun.app/running/reports.md): Explore FinalRun run artifacts, open the local report UI, read result.json, and inspect failures with video playback and device logs.
- [Inject secrets and variables into FinalRun test specs](https://docs.finalrun.app/tests/placeholders.md): Learn how to use ${secrets.*} and ${variables.*} placeholders in FinalRun test specs, how they resolve at run time, and how to configure env files safely.
- [FinalRun suite manifests: run groups of tests together](https://docs.finalrun.app/tests/suites.md): Learn how to create suite manifests that group related test files, organize them by feature, and run an entire suite with a single CLI command.
- [FinalRun YAML test format: fields, phases, examples](https://docs.finalrun.app/tests/yaml-format.md): Learn the FinalRun YAML test format: required fields, the three-phase execution model, allowed actions, and how to write reliable natural-language steps.
- [Troubleshoot FinalRun: common errors and device setup](https://docs.finalrun.app/troubleshooting.md): Diagnose and fix common FinalRun errors — missing workspace, unconfigured API keys, missing device tools — and verify host readiness with finalrun doctor.