Mobilewright CLI
Фреймворк автоматизации iOS и Android в стиле Playwright: агент ведет телефон по дереву доступности, скилл пишет тесты.
- 471 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Агент нажимает кнопки и вводит текст на симуляторе или реальном телефоне, включая рабочие учетные записи.
- Облачные провайдеры получают сборку приложения и сессию устройства.
Установка
- Работает в
Ручная установка
npm install mobilewright @mobilewright/test
npx mobilewright initЗатем `npx mobilewright doctor` проверяет окружение, а `npx mobilewright test` запускает тесты.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент нажимает кнопки и вводит текст на симуляторе или реальном телефоне, включая рабочие учетные записи.
- Облачные провайдеры получают сборку приложения и сессию устройства.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mobilewright автоматизирует устройства, симуляторы и эмуляторы iOS и Android через API в духе Playwright, построенный на `mobilecli`. Элементы ищут по роли и подписи (`screen.getByRole("button", { name: "Sign In" }).tap()`), а действия сами ждут, пока элемент станет видимым, доступным и неподвижным. Проверки `expect(...).toBeVisible()` опрашивают экран до срока. Фикстуры `@mobilewright/test` дополняют Playwright Test объектами `screen` и `device`. Для агентов фреймворк отдает дерево доступности экрана: детерминированное, экономное по токенам, без модели зрения и координат. Его используют вместе с mobile-mcp, Claude или Cursor. Скилл `mobilewright-cli` учит агента командам `mobilewright-cli devices`, `launch`, `snapshot`, `fill`, `tap` и `expect`, и по результатам писать тесты. Команда `npx mobilewright doctor` проверяет Xcode, Android SDK, симуляторы и ADB. Можно подключаться к удаленному `mobilecli` и облачным устройствам Mobile Next Cloud, BrowserStack и Sauce Labs.
Для кого. QA-инженерам и мобильным разработчикам, которые просят Claude Code или Cursor пройти сценарии в приложении и записать их как тесты.
Подходит, если
- Агент должен пройти авторизацию в приложении на симуляторе и сам написать тест.
- Один набор тестов нужен для iOS и Android с автоожиданием вместо ручных пауз.
- Тесты надо запускать на удаленных устройствах: в лаборатории или в облаке.
- Перед первым запуском требуется проверить Xcode, ADB и симуляторы командой `doctor`.
Не подходит, если
- Приложение веб-версии без мобильной оболочки: хватит обычного Playwright.
- Нет симулятора, эмулятора или подключенного устройства.
- Node.js старше 22.12.
Пример запроса к агенту
Запусти приложение на загруженном симуляторе, пройди вход через `mobilewright-cli` и оформи сценарий как тест с проверкой «Welcome back».Ограничения
Нужны Node.js 22.12 или новее и запущенный симулятор iOS, эмулятор Android или подключенное устройство. Работу с устройствами выполняет `mobilecli`: Mobilewright запускает его сам для локальных адресов. Для iOS нужен Xcode, для Android Android SDK и ADB, недостающее покажет `npx mobilewright doctor`. Облачные устройства BrowserStack, Sauce Labs и Mobile Next Cloud требуют отдельных аккаунтов. Последний коммит в репозитории: ноябрь 2026.
Как отключить. Выполните `npm uninstall mobilewright @mobilewright/test` в проекте и удалите скилл `mobilewright-cli` из каталога скиллов агента.
Частые вопросы
Как установить Mobilewright?
Командой `npm install mobilewright @mobilewright/test` и `npx mobilewright init`. Тесты запускаются командой `npx mobilewright test`.
Чем он отличается от Appium?
У Mobilewright API в стиле Playwright с автоожиданием из коробки, а установка сводится к одной команде npm. Appium требует сервера и драйверов, ожидания в нем настраивают вручную.
Как агент видит экран?
Через дерево доступности: роли, подписи и элементы с ссылками. Модель зрения, XPath и координаты не нужны. Вывод экономит токены.
Какие команды знает скилл mobilewright-cli?
`devices`, `launch`, `snapshot`, `fill`, `tap` и `expect`. После каждого действия CLI печатает свежий снимок экрана с ссылками на элементы.
Можно ли запускать в облаке?
Да, поддерживаются Mobile Next Cloud, BrowserStack и Sauce Labs, а также удаленный `mobilecli` для собственной лаборатории устройств.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыPlaywright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
MCP-сервер на Playwright от сообщества: браузерная автоматизация, скриншоты, эмуляция устройств и генерация тестового кода
Скилл дает Claude Code фоновый браузер: скриншоты на трех экранах, проверка фронтенда, сравнение до и после, сценарии с входом.
Запускает сценарии Maestro на Android, iOS и в браузере одним бинарным файлом без JVM и ставит скилл для агента.
MCP-сервер tapflow: агент управляет iOS-симуляторами и Android-эмуляторами на вашем Mac и воспроизводит сценарии для CI
Коротко о README
Playwright для телефонов: один API на iOS и Android, автоожидание и режим для агентов по дереву доступности. Скилл ведет тесты за вас.