droid-ash/finalrun-agentCLI на основе ИИ для тестирования Android и iOS приложений с использованием естественного языка. Генерирует, запускает и исправляет сквозные тесты на эмуляторах/симуляторах с отчетами о прохождении/непрохождении и видеозаписями.
finalrun.app • Документация • Блог • Лист ожидания облачных устройств • Присоединиться к сообществу Slack
finalrun-agent — это CLI на основе ИИ, который тестирует ваши Android и iOS приложения с помощью естественного языка. Вы пишете тест на понятном английском в YAML, FinalRun запускает ваше приложение на эмуляторе или симуляторе, использует модель ИИ (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 используйте finalrun cloud для iOS — Android работает локально. Флаги CI, переопределения переменных окружения и список артефактов находятся в заметках к последнему релизу.
FinalRun включает скиллы, которые позволяют вашему ИИ-агенту генерировать тесты, проверять рабочее пространство и запускать тесты — прямо из чата.
Скилл /finalrun-generate-test читает исходный код вашего приложения, определяет идентификатор приложения и генерирует полные спецификации тестов с настройкой, шагами и ожидаемым состоянием — сгруппированные по папкам функций.
Пример:
/finalrun-generate-test Сгенерировать тесты для функции аутентификации — охватить вход с правильными учётными данными, вход с неправильным паролем и выход из системы
Агент:
.finalrun/config.yaml и привязки окружения в .finalrun/env/.finalrun/tests/auth/ и набор тестов в .finalrun/suites/finalrun check для проверки всегоПосле генерации тестов скилл /finalrun-generate-test проверяет и запускает их.
Пример:
/finalrun-use-cli Запустить тесты аутентификации на Android
Скилл /finalrun-test-and-fix управляет полным циклом генерация → запуск → диагностика → исправление. Он создаёт тесты через finalrun-generate-test, запускает их через finalrun-use-cli, читает артефакты CLI (result.json, actions/, скриншоты, device.log) в случае сбоя, определяет, находится ли ошибка в коде приложения или тесте, применяет наименьшее возможное исправление и повторяет запуск, пока тест не пройдёт успешно.
Пример:
/finalrun-test-and-fix Проверить и исправить функцию оформления заказа end-to-end на Android
Добавьте этот контент в ваш AGENTS.md, чтобы автоматически запускать FinalRun, и вам не придётся каждый раз явно просить агента сгенерировать и запустить тесты. Это также позволит агенту исправлять ошибки, если они возникнут в процессе разработки.
FinalRun использует ваш собственный API-ключ провайдера ИИ для запуска тестов.
echo "GOOGLE_API_KEY=ваш-ключ-здесь" > .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 для информации о структуре монорепозитория, командах сборки и руководствах для контрибьюторов.