mobilecli CLI
mobilecli управляет iOS- и Android-устройствами, эмуляторами и приложениями из терминала, а скилл учит этому Claude Code
- 314 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- `fs rm`, `apps uninstall` и `apps clear` удаляют файлы и данные на подключенном устройстве
- `webview eval` выполняет произвольный JavaScript в веб-представлении, а `io` вводит текст и жмет кнопки от имени агента
- Скилл ставит пакет через npm без отдельного вопроса, а фоновый процесс остается в памяти до 30 минут простоя
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mobilecliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- `fs rm`, `apps uninstall` и `apps clear` удаляют файлы и данные на подключенном устройстве
- `webview eval` выполняет произвольный JavaScript в веб-представлении, а `io` вводит текст и жмет кнопки от имени агента
- Скилл ставит пакет через npm без отдельного вопроса, а фоновый процесс остается в памяти до 30 минут простоя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mobilecli — консольная утилита Mobile Next для телефонов, симуляторов и эмуляторов. Команда `mobilecli devices` показывает подключенные устройства, `device boot` и `device shutdown` запускают и останавливают эмуляторы и симуляторы, `screenshot` снимает экран в PNG или JPEG с масштабом и обрезкой. Через `mobilecli io` агент нажимает на координаты или на элемент из дерева интерфейса по ссылке вида @e5, вводит текст, читает и пишет буфер обмена, жмет аппаратные кнопки. Остальные команды: `apps` запускает, ставит, удаляет и очищает приложения, `fs` читает и пишет файлы на устройстве и в контейнерах приложений, `webview` открывает страницы, запрашивает DOM и выполняет JavaScript во встроенных веб-представлениях, а также во вкладках Chrome на Android и Safari на iOS. Журнал устройства идет потоком с фильтрами по процессу, тегу и уровню, отчеты о падениях читаются командами `device crashes`, геопозицию подменяет `device location set`. Скилл из папки skills/mobilecli задает агенту порядок работы: найти устройство, снять дерево интерфейса, нажать, проверить экран. Если бинарника нет, скилл ставит его через npm. Те же операции доступны по HTTP API на локальном порту и на удаленных устройствах Mobile Next через `mobilecli remote`.
Для кого. Мобильным разработчикам и тестировщикам, которые поручают Claude Code или Cursor прогнать сценарий на симуляторе или реальном телефоне.
Подходит, если
- Агент собирает приложение, ставит сборку на эмулятор и проходит экран входа с проверкой по скриншоту
- Сбой воспроизводится только на телефоне, и нужны журнал устройства с фильтром по процессу и отчет о падении
- Поведение зависит от места, поэтому геопозицию симулятора iOS подменяют одной командой
- Внутри приложения открыт WebView, и в нем нужно прочитать DOM или выполнить скрипт
- Базу SQLite из контейнера отладочного приложения надо забрать на компьютер командой `fs pull`
Не подходит, если
- Сценарии написаны на Appium или Maestro и идут в CI по расписанию без участия агента
- Клиент общается с инструментами только по MCP: у mobilecli в README описаны команды и HTTP API, MCP-режима нет
- Подмену геопозиции на реальном iPhone надо оставить после закрытия терминала: она живет, пока работает процесс с `--wait`
- К компьютеру подключен личный телефон с данными, и агенту нельзя доверять команды `fs rm` и `apps uninstall`
Пример запроса к агенту
Запусти симулятор iPhone, поставь сборку из ./build/App.zip, открой экран входа и сделай скриншотОграничения
- Лицензия FSL-1.1-Apache-2.0 запрещает конкурирующее коммерческое использование, через два года каждая версия переходит на Apache 2.0.
- На реальном iOS касания, трансляция экрана и дерево интерфейса работают только со служебной программой на устройстве, для нее нужен профиль подписи (`--provisioning-profile`).
- Файловые команды доступны на Android и в симуляторе iOS. Пути внутри `/data/user/` читаются через `run-as`, поэтому приложение должно быть отладочным.
- Подмена GPS на реальном iPhone держится, пока работает процесс `mobilecli`, и требует флага `--wait`.
Как отключить. Скилл убирает команда `npx skills remove mobilecli`, пакет — `npm uninstall -g mobilecli`. Фоновый процесс останавливает `mobilecli daemon stop`, он и сам завершается после 30 минут простоя.
Частые вопросы
Как поставить mobilecli в Claude Code?
Поставьте пакет командой `npm install -g mobilecli@latest`, затем скилл командой `npx skills add mobile-next/mobilecli`. После этого попросите агента показать устройства, он запустит `mobilecli devices`. Для iOS-симулятора понадобятся Xcode Command Line Tools, для Android — `adb` в PATH.
Нужна ли служебная программа на телефоне?
На Android нет, на iOS да. Команда `mobilecli agent install --device <id>` ставит ее, без нее не работают касания, трансляция экрана и дерево интерфейса. На реальном iPhone к команде добавляется профиль подписи.
Может ли агент удалять файлы и приложения на устройстве?
Да, `fs rm` удаляет файлы и папки, `apps uninstall` — приложения, `apps clear` стирает данные приложения. Берите эмулятор или отдельное тестовое устройство и просите подтверждение перед такими шагами.
Можно ли пользоваться mobilecli без агента?
Да, все команды работают в обычной оболочке. Тот же набор доступен по HTTP API: JSON-RPC принимает демон на порту 12000, например метод `device.logs` для журнала устройства.
Чем mobilecli отличается от Appium?
mobilecli — одна утилита с набором команд, которые агент вызывает по одной через скилл. Appium работает как сервер автоматизации со своими драйверами и сценариями на языках тестов. Для разовой работы агента с устройством хватает mobilecli, для регрессионных прогонов чаще берут Appium.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыИИ-агент для телефона в терминале: цель задают обычной фразой, он читает экран и сам решает, куда нажать и что ввести
Скиллы и CLI, чтобы Claude Code, Codex и OpenCode управляли Android-телефоном: открывали приложения, нажимали, вводили текст и тестировали сценарии
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
claude-in-mobile — управление телефоном и приложениями
claude-in-mobile
MCP-сервер: агент управляет Android, iOS-симулятором, HarmonyOS, Aurora, десктопом и браузером, снимает экран и отлаживает приложения
Скилл и CLI для управления Android-телефоном через ADB и vision-модели: агент открывает приложения, ищет, заказывает и проверяет результат
Дает Claude Code и Codex управлять настоящим iPhone: читать экран, нажимать, вводить текст и листать в любом приложении
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mobilecli (эта карточка) | нет | 314 | ||
| Mobile MCP | нет | не нужна | 10 325 | MCP-сервер к тем же устройствам, а mobilecli работает обычными командами оболочки |
| Appium MCP | да | не нужна | 518 | сеансы Appium и тесты на Java, у mobilecli нет сервера автоматизации |
Коротко о README
README открывается списком возможностей и таблицей платформ, затем идут установка через npm, настройка агента и справочник команд: снимки экрана, дерево интерфейса, управление устройством, подмена геопозиции, приложения, файловая система, служебная программа на iOS, веб-представления, отчеты о падениях, журналы и удаленные устройства. В конце описаны скилл для Claude Code, фоновый процесс и HTTP API.