agent-device
CLI, MCP-сервер и типизированный Node.js API, чтобы агент проверял свои правки в живом мобильном приложении на iOS, Android и других платформах
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Запускает и управляет приложениями на устройствах, эмуляторах и симуляторах
- Читает состояние экрана, логи и сетевые данные приложения
- Может подключаться к удаленным облакам устройств
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-deviceОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Установите утилиту
npm install -g agent-deviceУстанови CLI: npm install -g agent-device@latest, затем проверь окружение через agent-device doctor. Для инструментов MCP запусти agent-device mcp и добавь сервер в конфигурацию агента.
Другие способы из описания автора
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, если добавляли его.
Проверка безопасности
- Запускает и управляет приложениями на устройствах, эмуляторах и симуляторах
- Читает состояние экрана, логи и сетевые данные приложения
- Может подключаться к удаленным облакам устройств
Коротко о README
README описывает инструмент для автоматизации и проверки мобильных приложений кодовыми агентами через CLI, встроенный MCP-сервер или типизированный Node.js API. Агент читает снимки дерева доступности, действует через ссылки на элементы и селекторы и сохраняет скриншоты, видео и логи как доказательства. Быстрый старт показывает установку через npm, команду doctor и пример сценария в приложении Контакты на iOS. Инструмент работает с Claude Code, Codex, Cursor, Windsurf, Cline, Goose и любым агентом, который умеет запускать CLI или ходить по MCP. Лицензия MIT.
Частые вопросы
Это CLI или MCP-сервер?
И то, и другое. Есть глобальный CLI, встроенный stdio MCP-сервер agent-device mcp и типизированный Node.js API, все три идут через один и тот же путь исполнения.
Какие платформы поддерживаются?
iOS, Android и HarmonyOS на симуляторах, эмуляторах и физических устройствах, а также tvOS, Android TV, Vega OS, web, macOS и Linux.
Похожие
CLI для тестирования и ред-тиминга LLM-приложений: сравнение моделей, автоматические проверки в CI и поиск уязвимостей
Playwright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете
Официальный MCP-сервер SonarSource: проблемы качества и безопасности, quality gates и анализ кода из SonarQube Server и Cloud