droid-ash/finalrun-agentCLI pilotée par IA pour tester des applications Android et iOS en langage naturel. Génère, exécute et corrige des tests de bout en bout sur émulateurs/simulateurs avec des rapports de succès/échec et des journaux vidéo.
finalrun.app • Docs • Blog • Liste d’attente Cloud Device • Rejoindre la communauté Slack
finalrun-agent est une CLI pilotée par l’IA qui teste vos applications Android et iOS en langage naturel. Vous rédigez un test en anglais simple dans un fichier YAML, FinalRun lance votre application sur un émulateur ou un simulateur, utilise un modèle d’IA (Gemini, GPT ou Claude) pour visualiser l’écran et exécuter chaque étape (toucher, balayer, saisir), puis génère un rapport de réussite/échec avec vidéo et journaux de l’appareil.
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
Les tests iOS locaux nécessitent macOS (xcodebuild). Sur Windows, utilisez finalrun cloud pour iOS — Android fonctionne en local. Les indicateurs CI, les surcharges d’environnement et la liste des artefacts se trouvent dans les notes de version les plus récentes.
FinalRun embarque des skills qui permettent à votre agent de codage IA de générer des tests, de valider les espaces de travail et d’exécuter les tests — le tout depuis le chat.
La compétence /finalrun-generate-test lit le code source de votre application, déduit son identité et génère des spécifications de test complètes avec configuration, étapes et état attendu — organisées par dossier de fonctionnalité.
Exemple :
/finalrun-generate-test Génère des tests pour la fonctionnalité d'authentification — couvre la connexion avec identifiants valides, la connexion avec mot de passe erroné et la déconnexion
L’agent va :
.finalrun/config.yaml et les liaisons d’environnement dans .finalrun/env/.finalrun/tests/auth/ et une suite sous .finalrun/suites/finalrun check pour tout validerLa compétence /finalrun-generate-test valide et exécute le test une fois vos tests générés.
Exemple :
/finalrun-use-cli Exécute les tests d'authentification sur Android
La compétence /finalrun-test-and-fix orchestre la boucle complète générer → exécuter → diagnostiquer → corriger. Elle crée les tests via finalrun-generate-test, les exécute via finalrun-use-cli, lit les artefacts de la CLI (result.json, actions/, captures d’écran, device.log) en cas d’échec, classifie si le bogue se trouve dans le code de l’application ou dans le test, applique la correction la plus ciblée, et relance jusqu’à ce que l’exécution soit verte.
Exemple :
/finalrun-test-and-fix Vérifier et corriger la fonctionnalité de paiement de bout en bout sur Android
Ajoutez ce contenu à votre AGENTS.md pour déclencher automatiquement FinalRun, afin de ne pas avoir à demander explicitement à votre agent de générer et exécuter des tests à chaque fois. Cela permettra également à votre agent de corriger les éventuelles erreurs de développement.
FinalRun utilise votre propre clé API de fournisseur d’IA pour exécuter les tests.
echo "GOOGLE_API_KEY=votre-clé-ici" > .env
| Fournisseur | Variable d’environnement |
|---|---|
google/... | GOOGLE_API_KEY |
openai/... | OPENAI_API_KEY |
anthropic/... | ANTHROPIC_API_KEY |
Les exécutions de tests consomment des jetons API de votre fournisseur configuré — la facturation standard de l’API s’applique.
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
Documentation complète : docs.finalrun.app
--app et surcharges par environnementConsultez CONTRIBUTING.md pour la structure du monorepo, les commandes de construction et les directives pour les contributeurs.