droid-ash/finalrun-agentCLI impulsado por IA para probar aplicaciones Android e iOS usando lenguaje natural. Genera, ejecuta y corrige pruebas de extremo a extremo en emuladores/simuladores con informes de aprobado/fallido y registros de video.
finalrun.app • Documentación • Blog • Lista de espera de dispositivos en la nube • Únete a la comunidad de Slack
finalrun-agent es una CLI impulsada por IA que prueba tus aplicaciones Android e iOS usando lenguaje natural. Escribes una prueba en inglés sencillo en YAML, FinalRun lanza tu app en un emulador o simulador, usa un modelo de IA (Gemini, GPT o Claude) para ver la pantalla y realizar cada paso — tocar, deslizar, escribir — y produce un informe de aprobado/fallo con video y registros 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
Las pruebas locales en iOS requieren macOS (xcodebuild). En Windows, usa finalrun cloud para iOS — Android funciona localmente. Las banderas de CI, anulaciones de entorno y la lista de artefactos están en las notas de la última versión.
FinalRun incluye skills que permiten a tu agente de IA generador de código crear pruebas, validar espacios de trabajo y ejecutar pruebas — todo desde el chat.
La skill /finalrun-generate-test lee el código fuente de tu app, deduce la identidad de la aplicación y genera especificaciones de prueba completas con configuración, pasos y estado esperado — organizadas por carpeta de funcionalidad.
Ejemplo:
/finalrun-generate-test Genera pruebas para la funcionalidad de autenticación — cubre inicio de sesión con credenciales válidas, inicio de sesión con contraseña incorrecta y cierre de sesión
El agente:
.finalrun/config.yaml y los enlaces de entorno en .finalrun/env/.finalrun/tests/auth/ y una suite en .finalrun/suites/finalrun check para validar todoLa skill /finalrun-generate-test valida y ejecuta la prueba una vez que se han generado tus pruebas.
Ejemplo:
/finalrun-use-cli Ejecuta las pruebas de autenticación en Android
La skill /finalrun-test-and-fix orquesta el ciclo completo generar → ejecutar → diagnosticar → corregir. Crea pruebas mediante finalrun-generate-test, las ejecuta mediante finalrun-use-cli, lee los artefactos de la CLI (result.json, actions/, capturas de pantalla, device.log) en caso de fallo, clasifica si el error está en el código de la app o en la prueba, aplica la corrección más específica y vuelve a ejecutar hasta que la ejecución sea exitosa.
Ejemplo:
/finalrun-test-and-fix Verifica y corrige la funcionalidad de pago de extremo a extremo en Android
Agrega este contenido a tu AGENTS.md para activar automáticamente FinalRun, de modo que no tengas que pedir explícitamente a tu agente que genere y ejecute pruebas cada vez. Esto también permitirá que tu agente corrija problemas si hay algún error durante el desarrollo.
FinalRun usa tu propia clave de API del proveedor de IA para ejecutar pruebas.
echo "GOOGLE_API_KEY=tu-clave-aquí" > .env
| Proveedor | Variable de entorno |
|---|---|
google/... | GOOGLE_API_KEY |
openai/... | OPENAI_API_KEY |
anthropic/... | ANTHROPIC_API_KEY |
Las ejecuciones de pruebas consumen tokens de API de tu proveedor configurado; se aplica la facturación estándar de la 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
Documentación completa: docs.finalrun.app
--app y anulaciones por entornoConsulta CONTRIBUTING.md para la estructura del monorepositorio, comandos de compilación y pautas para contribuyentes.