maestro-runner CLI
Запускает сценарии Maestro на Android, iOS и в браузере одним бинарным файлом без JVM и ставит скилл для агента.
- 529 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Тесты управляют устройствами и эмуляторами: нажимают кнопки и вводят текст в приложениях.
- Установка идет через `curl | bash`, а подписанный агент для iPhone использует ваш Apple Team ID.
Установка
- Работает в
Ручная установка
curl -fsSL https://open.devicelab.dev/install/maestro-runner | bashПервая команда установки из README. Затем `maestro-runner skills install` кладет скилл для агента.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Тесты управляют устройствами и эмуляторами: нажимают кнопки и вводят текст в приложениях.
- Установка идет через `curl | bash`, а подписанный агент для iPhone использует ваш Apple Team ID.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
maestro-runner — открытый запускатель UI-тестов в формате Maestro YAML, написанный на Go. Он выполняет существующие сценарии без правок на эмуляторах и реальных устройствах Android, на симуляторах и iPhone, в Chrome по CDP и в облаках через Appium. Встроены параллельный запуск на нескольких устройствах, отчеты HTML, JUnit и Allure, скрипты на JavaScript. Команда `maestro-runner skills install` записывает скилл в `~/.claude/skills/maestro-runner/SKILL.md`. Он учит агента писать сценарии, запускать их, смотреть иерархию экрана и читать отчеты. Для диагностики есть `doctor` и `devices`, а `hierarchy` и `screenshot` показывают, что видит тест.
Для кого. Мобильным тестировщикам и командам React Native, Flutter и Expo, которые гоняют UI-сценарии Maestro и хотят доверить агенту их написание.
Подходит, если
- Сценарии Maestro идут медленно на CI, и нужен более быстрый запуск без JVM.
- Тест падает с непонятной ошибкой, и агент смотрит иерархию экрана, чтобы подобрать селектор.
- Один набор сценариев прогоняют на нескольких устройствах параллельно.
- Нужен запуск на реальном iPhone, а не только на симуляторе.
- Веб-интерфейс проверяют в Chrome теми же сценариями YAML, что и мобильное приложение.
Не подходит, если
- Нужен официальный Maestro Studio и облако Maestro: это независимая замена со своим движком.
- Тесты написаны на XCUITest, Espresso или Detox, а YAML Maestro не используется.
- Запуск идет на Windows без WSL: бинарные сборки есть для macOS и Linux.
Пример запроса к агенту
Запусти `maestro-runner doctor`, покажи иерархию экрана на подключенном Android и напиши сценарий входа в приложение.Ограничения
Сборки есть для macOS и Linux на arm64 и x64, на Windows работают через WSL. Это отдельный движок, читающий формат YAML от Maestro, поэтому поведение отдельных команд может отличаться. Для реального iPhone нужен `--team-id` Apple для подписи агента. Установочная команда запускает скрипт через `curl | bash`, прочитайте его до выполнения. Команда `doctor` покажет недостающее: Android SDK, Xcode или браузер.
Как отключить. Удалите бинарный файл `maestro-runner` (или пакет из `node_modules`) и каталог `~/.claude/skills/maestro-runner`. Отчеты тестов лежат в папке запуска и удаляются отдельно.
Частые вопросы
Нужно ли переписывать сценарии Maestro?
Нет. Существующий YAML запускается как есть командой `maestro-runner test flow.yaml`.
Как поставить скилл в репозиторий, а не глобально?
Командой `maestro-runner skills install --dir .claude/skills/maestro-runner`. Флаг `--print` просто выводит текст скилла.
На чем запускаются тесты?
На Android (эмуляторы и устройства), iOS (симуляторы и iPhone), в Chrome и в облаках BrowserStack, Sauce Labs, LambdaTest через Appium.
Как поставить через npm?
`npx maestro-runner test flows/` запускает без установки, а `npm install --save-dev maestro-runner` закрепляет версию в проекте.
Какие отчеты есть?
HTML, JUnit XML и совместимые с Allure.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкиллы Midscene управляют браузером, ПК, Android, iOS и HarmonyOS по скриншотам и пишут E2E-тесты на Vitest через Claude Code или OpenClaw
Фреймворк автоматизации iOS и Android в стиле Playwright: агент ведет телефон по дереву доступности, скилл пишет тесты.
CLI для управления экраном iOS, Android и браузера на естественном языке. Сессию сохраняют как trail и гоняют в CI.
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
MCP-сервер для сквозных тестов: агент управляет запущенным приложением на Flutter, React Native, Electron или сайтом
Скилл noqa-testing учит агента тестировать iOS и Android: читать экран, нажимать, писать кейсы и гонять их на реальном телефоне
Коротко о README
README показывает установку (curl, npm), первый запуск через `doctor` и `devices`, команды запуска для трех платформ, раздел про агентов и список драйверов и возможностей.