Show HN: Finalrun – Spec-driven testing using English and vision for mobile apps

Summary

finalrun.app • Blog • Cloud Device Waitlist • Join Slack Community finalrun-agent is an AI-driven CLI for mobile app testing. You define repo-local tests in YAML, run them against Android or iOS targets, and inspect local run artifacts from the terminal. Run the installer to set up everything — Node.js, the CLI, skills, and platform tools: curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bash The installer checks for Node.js (installs via nvm if missing), installs the finalrun CLI globally, adds FinalRun skills for Claude Code / Codex, and walks you through Android and iOS tool setup. The package installs the finalrun command and also exposes finalrun-agent as an alias. During global installation, FinalRun stages its native driver assets under ~/.finalrun/assets/<version>/. Run artifacts are stored separately under ~/.finalrun/workspaces/<workspace-hash>/artifacts. In your app repo, .finalrun/ holds YAML specs, environment binding files (.finalrun/env/*.yaml), and config. Secret values and API keys belong in workspace-root .env files (see Important: Environment variables and .env files), not in YAML. Watch the demo on YouTube: https://www.youtube.com/watch?v=q6CFoN-ohT4 Run the install script (see above) to set up the CLI and platform tools. Create a .finalrun/ workspace in the mobile app repo you want to test. Add at least one YAML spec under .finalrun/tests/. Configure the AI provider key you want to use. Validate the workspace with finalrun check. Run a test with finalrun test. Example workspace layout (workspace root is the directory that contains .finalrun/): .env # optional; shared defaults (do not commit — see .gitignore below) .env.dev # optional; values when using env name "dev" (do not commit) .finalrun/ config.yaml tests/ smoke.yaml auth/ login.yaml suites/ smoke.yaml env/ dev.yaml Minimal test spec: name: login_smoke description: Verify that a user can log in and reach the home screen. steps: - Launch the ap...