Skip to main content

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.

FinalRun ships three AI agent skills for Claude Code, Cursor, and Codex (and any other agent that supports skills). Each one handles a different part of the flow:
  • /finalrun-generate-test — turns a plain-English description into a YAML test file.
  • /finalrun-use-cli — runs the FinalRun CLI from your agent and shows you the result.
  • /finalrun-test-and-fix — does the whole loop for you: writes the test, runs it, looks at the failure, and fixes things until it passes.
This guide assumes you’ve finished Installation and have either a FinalRun Cloud API key or a provider (BYOK) key configured.
1

Open your app's repo in your AI coding agent

Start Claude Code, Cursor, or Codex from your mobile app’s repo folder. The skills run from chat — you don’t need to switch tools.
The FinalRun installer adds the skills for you. If you skipped that, install them now:
npx skills add final-run/finalrun-agent -g
For the full skill reference, see AI Agent Skills.
2

Write tests with /finalrun-generate-test

Ask the agent to write tests for a feature in your app. The skill reads your code, figures out the app’s package name or bundle ID, sets up the .finalrun/ folder, and writes the test files for you.
/finalrun-generate-test Write tests for the login feature — cover login with the right password, login with the wrong password, and logout
The skill shows you a plan first and waits for you to approve it before writing any files. Once you say yes, it adds the tests under .finalrun/tests/<feature>/ and checks everything is set up correctly.
3

Run and fix with /finalrun-test-and-fix

Hand running and fixing to this skill. It runs the new tests, looks at the screenshots, video, and logs when something fails, decides whether the bug is in the app or in the test, makes the smallest fix that helps, and runs the test again until it passes.
/finalrun-test-and-fix Verify and fix the login feature on Android
Just want to run, not fix? Use the simpler skill:
/finalrun-use-cli Run the login tests on Android
4

See the report

List your recent runs and open the local report to see screenshots, video, and device logs:
finalrun runs
finalrun start-server

​
Make it automatic

Add a rule to your AGENTS.md so the agent runs /finalrun-test-and-fix after every UI change. A passing FinalRun run becomes part of “done” for any UI work — see Auto-trigger FinalRun.

​
What’s next