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

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 Demo

... continue reading