/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.
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: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 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/ folder, and writes the test files for you..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.
Just want to run, not fix? Use the simpler skill:
4
See the report
List your recent runs and open the local report to see screenshots, video, and device logs:
Make it automatic
Add a rule to yourAGENTS.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
- AI Agent Skills — full guide to all three skills.
- YAML Test Format — the format the skills use, in case you want to read or edit a test by hand.
- CLI Reference — every
finalruncommand and flag, for running tests without an agent. - Workspace Configuration — app identity, environments, and the
--appflag.