
AI駆動のCLIで、自然言語を使ってAndroidおよびiOSアプリをテストします。エミュレーター/シミュレーター上でエンドツーエンドテストを生成、実行、修正し、合格/不合格レポートと動画ログを提供します。
finalrun.app • Docs • Blog • Cloud Device Waitlist • Join Slack Community
finalrun-agent は、自然言語を使用してAndroidおよびiOSアプリをテストするAI駆動のCLIです。プレーンな英語でYAMLにテストを記述すると、FinalRunがエミュレータまたはシミュレータ上でアプリを起動し、AIモデル(Gemini、GPT、Claude)を使用して画面を認識し、タップ、スワイプ、タイピングなどの各ステップを実行して、合格/不合格レポートとビデオおよびデバイスログを生成します。
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.ps1 | iex
iOSのローカルテストにはmacOS(xcodebuild)が必要です。Windowsでは、iOSの場合はfinalrun cloudを使用してください。Androidはローカルで動作します。CIフラグ、環境変数の上書き、およびアーティファクトリストは、最新のリリースノートにあります。
FinalRunには、AIコーディングエージェントがチャットからテストの生成、ワークスペースの検証、テストの実行を可能にするスキルが付属しています。
/finalrun-generate-test スキルは、アプリのソースコードを読み取り、アプリのIDを推測し、セットアップ、手順、期待される状態を含む完全なテストスペックを生成します。これらは機能フォルダごとに整理されます。
例:
/finalrun-generate-test Generate tests for the authentication feature — cover login with valid credentials, login with wrong password, and logout
エージェントは以下のことを行います:
.finalrun/config.yaml と .finalrun/env/ 内の環境バインディングを設定します。.finalrun/tests/auth/ の下にYAMLスペックを生成し、.finalrun/suites/ の下にスイートを生成します。finalrun check を実行してすべてを検証します。/finalrun-generate-test スキルは、テストが生成されたらテストを検証して実行します。
例:
/finalrun-use-cli Run the auth tests on Android
/finalrun-test-and-fix スキルは、完全な「生成→実行→診断→修正」のループを調整します。これは、finalrun-generate-test を介してテストを作成し、finalrun-use-cli を介してそれらを実行し、失敗時にCLIアーティファクト(result.json、actions/、スクリーンショット、device.log)を読み取り、バグが アプリコード か テスト かを分類し、最も狭い修正を適用し、実行が成功するまで再実行します。
例:
/finalrun-test-and-fix Verify and fix the checkout feature end-to-end on Android
この コンテンツ を AGENTS.md に追加してFinalrunを自動トリガーすると、毎回エージェントに明示的にテストの生成と実行を依頼する必要がなくなります。また、開発中にエラーがあった場合にエージェントが問題を修正できるようになります。
FinalRunは、テストを実行するために独自のAIプロバイダAPIキーを使用します。
echo "GOOGLE_API_KEY=your-key-here" > .env
| プロバイダ | 環境変数 |
|---|---|
google/... | GOOGLE_API_KEY |
openai/... | OPENAI_API_KEY |
anthropic/... | ANTHROPIC_API_KEY |
テスト実行は、設定されたプロバイダのAPIトークンを消費します。標準的なAPI課金が適用されます。
finalrun test smoke.yaml --platform android --model google/gemini-3-flash-preview
finalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-preview
完全なドキュメント: docs.finalrun.app
--appフラグ、環境ごとのオーバーライドモノレポの構造、ビルドコマンド、コントリビュータガイドラインについては、CONTRIBUTING.md を参照してください。