iCTRL — скилл
Сервис автоматизации iPhone на XCUITest с JSON-RPC API: агент нажимает, печатает и читает экран по инструкции с устройства.
- 591 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Ключ спаривания дает полный контроль над телефоном: ввод, экран и все приложения.
- Агент без присмотра может совершить необратимые действия в приложениях.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/ictrlОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключ спаривания дает полный контроль над телефоном: ввод, экран и все приложения.
- Агент без присмотра может совершить необратимые действия в приложениях.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
iCTRL запускает на iPhone долгоживущий раннер XCUITest и открывает JSON-RPC 2.0 по HTTP на порту 8200. Агент или любой HTTP-клиент нажимает, листает, печатает, читает дерево интерфейса, делает снимки экрана, открывает ссылки и запускает приложения. Сервис рассчитан на работу с моделью: по адресу `/skill` отдается полное руководство, по `/schema` описание методов. Файл `SKILL.md` в репозитории учит агента спариванию с телефоном и работе через клиент, который скачивается с самого устройства.
Для кого. Разработчикам и исследователям, которые тестируют мобильные приложения на собственном iPhone и хотят управлять устройством агентом.
Подходит, если
- Агент должен пройти сценарий в iOS-приложении и сверить экран на каждом шаге.
- Автоматизированный тест строится на XCUITest, но управлять им хочется естественным языком.
- Нужно получить дерево интерфейса и снимок экрана для разбора ошибки.
- Исследуется поведение приложения на реальном устройстве.
Не подходит, если
- Устройство чужое или аккаунты не ваши: автор допускает только свои устройства и аккаунты.
- Агента оставляют без присмотра рядом с платежами и сообщениями.
- Достаточно симулятора: тогда проще обычные инструменты Xcode.
Пример запроса к агенту
Подключись к телефону, открой настройки, найди раздел Wi-Fi и сделай снимок экрана без изменения параметров.Ограничения
Проект предназначен только для автоматизированного тестирования и исследований. Владелец ключа спаривания получает полный контроль над телефоном, включая ввод, содержимое экрана и все приложения. Установка требует подписи через SideStore или Xcode и подключения образа разработчика. Условия сторонних приложений остаются на совести пользователя. Обновления iOS и правила сторонней подписи способны сломать установку, поэтому проверяйте совместимость версий.
Как отключить. Остановите сервер на телефоне, выключите удаленный доступ и удалите раннер. Одобренные ключи спаривания отзовите на устройстве.
Частые вопросы
С какими агентами работает?
С любым, кто умеет ходить по HTTP: OpenClaw, Hermes, Minis, Claude Code, Codex. Для Minis есть отдельная оптимизация.
Нужен ли Mac?
Для сборки и подписи обычно да, но образ разработчика можно подключить на устройстве, а подпись пройти через SideStore.
Как агент узнает методы?
Запрос к `/skill` возвращает руководство, `/schema` описывает каждый метод и его параметры.
Безопасно ли оставлять сервер включенным?
Нет. Ключ спаривания дает полный контроль над телефоном, держите удаленный доступ выключенным без нужды.
Какой порт использует сервис?
JSON-RPC 2.0 по HTTP слушает порт `8200`, запросы шифруются.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыДает Claude Code и Codex управлять настоящим iPhone: читать экран, нажимать, вводить текст и листать в любом приложении
Скилл со скриптами для сборки iOS-приложений и управления симулятором через дерево доступности, с экономным выводом для агента
mobilecli управляет iOS- и Android-устройствами, эмуляторами и приложениями из терминала, а скилл учит этому Claude Code
MCP-сервер, который ставится на iPhone с джейлбрейком и дает агенту 46 инструментов: касания, снимки экрана, OCR, приложения, файлы, логи
CLI проверяет экраны SwiftUI и гоняет тесты iOS без Симулятора: агент читает дерево доступности и правит вьюхи за 2 секунды.
MCP-сервер для управления iOS и Android: симуляторы, эмуляторы и реальные устройства через дерево доступности и скриншоты
Коротко о README
README открывается предупреждением, затем идут архитектура, подготовка устройства, спаривание и способы подключения агента.