droid-ash/finalrun-agentCLI basata su intelligenza artificiale per testare app Android e iOS usando linguaggio naturale. Genera, esegue e corregge test end-to-end su emulatori/simulatori con report di superamento/fallimento e registrazioni video.
finalrun.app • Documentazione • Blog • Lista d'attesa dispositivo cloud • Unisciti alla community Slack
finalrun-agent è un CLI basato su AI che testa le tue app Android e iOS usando linguaggio naturale. Scrivi un test in inglese semplice in YAML, FinalRun avvia la tua app su un emulatore o simulatore, utilizza un modello AI (Gemini, GPT o Claude) per vedere lo schermo ed eseguire ogni passaggio — toccare, scorrere, digitare — e produce un report superato/non superato con video e log del dispositivo.
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
I test locali su iOS richiedono macOS (xcodebuild). Su Windows, usa finalrun cloud per iOS — Android funziona localmente. I flag CI, le sovrascritture di ambiente e la lista degli artefatti si trovano nelle note di rilascio più recenti.
FinalRun include skills che permettono al tuo agente AI di generare test, validare workspace ed eseguire test — tutto tramite chat.
La skill /finalrun-generate-test legge il codice sorgente della tua app, deduce l'identità dell'app e genera specifiche di test complete con setup, passaggi e stato atteso — organizzate per cartella di funzionalità.
Esempio:
/finalrun-generate-test Generate tests for the authentication feature — cover login with valid credentials, login with wrong password, and logout
L'agente:
.finalrun/config.yaml e i collegamenti all'ambiente in .finalrun/env/.finalrun/tests/auth/ e una suite in .finalrun/suites/finalrun check per validare tuttoLa skill /finalrun-generate-test valida ed esegue il test una volta generati i tuoi test.
Esempio:
/finalrun-use-cli Run the auth tests on Android
La skill /finalrun-test-and-fix orchestra il ciclo completo genera → esegui → diagnostica → correggi. Crea test tramite finalrun-generate-test, li esegue tramite finalrun-use-cli, legge gli artefatti CLI (result.json, actions/, screenshot, device.log) in caso di fallimento, classifica se il bug è nel codice dell'app o nel test, applica la correzione più mirata e riesegue fino a quando l'esecuzione è verde.
Esempio:
/finalrun-test-and-fix Verify and fix the checkout feature end-to-end on Android
Aggiungi questo contenuto al tuo AGENTS.md per attivare automaticamente Finalrun, così non devi chiedere esplicitamente al tuo agente di generare ed eseguire test ogni volta. Questo permetterà anche al tuo agente di correggere problemi se c'è qualche errore durante lo sviluppo.
FinalRun utilizza la tua chiave API del fornitore AI per eseguire test.
echo "GOOGLE_API_KEY=your-key-here" > .env
| Fornitore | Variabile d'ambiente |
|---|---|
google/... | GOOGLE_API_KEY |
openai/... | OPENAI_API_KEY |
anthropic/... | ANTHROPIC_API_KEY |
Le esecuzioni dei test consumano token API dal tuo fornitore configurato — si applica la fatturazione API standard.
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
Documentazione completa: docs.finalrun.app
--app e sovrascritture per ambienteVedi CONTRIBUTING.md per la struttura del monorepo, i comandi di build e le linee guida per i contributori.