agent-device CLI
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
- 5 355 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает и управляет приложениями на устройствах, эмуляторах и симуляторах
- Читает состояние экрана, логи и сетевые данные приложения
- Может подключаться к удаленным облакам устройств
Установка
- Работает в
Ручная установка
npm install -g agent-device@latest
agent-device doctorЗапустите doctor до передачи CLI агенту, чтобы проверить окружение платформы.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает и управляет приложениями на устройствах, эмуляторах и симуляторах
- Читает состояние экрана, логи и сетевые данные приложения
- Может подключаться к удаленным облакам устройств
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент дает кодовому агенту обратную связь от запущенного приложения: он инспектирует экран, управляет им, снимает диагностику и подтверждает результат. Агент читает токен-экономные снимки дерева доступности вместо разбора одних скриншотов, действует через ссылки на элементы и селекторы, сохраняет скриншоты, видео и логи как доказательства. Поддерживаются iOS, Android и HarmonyOS на симуляторах, эмуляторах и физических устройствах, а также tvOS, Android TV, Vega OS, web, macOS и Linux. Работать можно через CLI, встроенный stdio MCP-сервер или типизированный Node.js API, поэтому подключается любой агент, умеющий запускать команды или ходить по MCP. Рабочие шаги можно сохранять как скрипты .ad для повторного запуска локально и в CI.
Для кого. Для мобильных разработчиков и QA-инженеров, которым нужно, чтобы агент проверял приложение на устройстве.
Подходит, если
- Нужно, чтобы агент проверил свою правку в запущенном мобильном приложении
- Нужно снять доказательства бага: скриншоты, видео, логи и трейсы
- Нужно повторять сценарии на устройствах локально или в CI
Не подходит, если
- Не настроено окружение целевой платформы: Xcode и симуляторы, Android SDK и эмуляторы
- Нужна ручная приемка, а не автоматическая проверка агентом
Пример запроса к агенту
Открой приложение на симуляторе iOS, пройди сценарий входа и сохрани скриншот и логи как доказательствоОграничения
Требует Node.js 22.12 или новее, для веб-автоматизации 24 или новее, и настроенного окружения целевой платформы: Xcode и симуляторы для iOS, Android SDK и эмуляторы для Android и так далее. Проверьте готовность командой agent-device doctor. Часть возможностей и набор команд зависят от конкретной платформы и установленных инструментов. Для точных снимков экрана приложению нужны понятные метки, роли и test ID в дереве доступности.
Как отключить. Удалите глобальный пакет: npm uninstall -g agent-device. Уберите блок agent-device из конфигурации MCP, если добавляли его.
Частые вопросы
Это CLI или MCP-сервер?
И то, и другое. Есть глобальный CLI, встроенный stdio MCP-сервер agent-device mcp и типизированный Node.js API, все три идут через один и тот же путь исполнения.
Какие платформы поддерживаются?
iOS, Android и HarmonyOS на симуляторах, эмуляторах и физических устройствах, а также tvOS, Android TV, Vega OS, web, macOS и Linux.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСамообучающийся QA-агент: тесты для веба и мобильных на естественном языке, которые сами чинятся и запоминают прогоны
MCP-сервер, который проверяет, правда ли агент закончил: гоняет реальное приложение и возвращает вердикт прошло, не прошло, неясно с указанием файла и строки
Агент получает живую сессию вашего приложения на вебе, iOS или Android, видит экран, пишет тесты и сам проверяет правки.
Локальный отладчик TypeScript-агентов: дерево шагов, проверка траектории в CI и архив доказательств без аккаунта.
MCP-сервер tapflow: агент управляет iOS-симуляторами и Android-эмуляторами на вашем Mac и воспроизводит сценарии для CI
BrowserStack MCP Server — тесты на реальных устройствах
BrowserStack MCP Server
Официальный MCP-сервер BrowserStack: реальные устройства, автотесты и тест-кейсы под управлением агента из редактора
Коротко о README
README описывает инструмент для автоматизации и проверки мобильных приложений кодовыми агентами через CLI, встроенный MCP-сервер или типизированный Node.js API. Агент читает снимки дерева доступности, действует через ссылки на элементы и селекторы и сохраняет скриншоты, видео и логи как доказательства. Быстрый старт показывает установку через npm, команду doctor и пример сценария в приложении Контакты на iOS. Инструмент работает с Claude Code, Codex, Cursor, Windsurf, Cline, Goose и любым агентом, который умеет запускать CLI или ходить по MCP. Лицензия MIT.