Repolode
leeguooooo

leeguooooo/iphone-use

Позволяет AI-агентам, например Claude Code или Codex, считывать экран, нажимать, вводить текст и свайпать на реальном iPhone через USB или Wi-Fi с помощью MCP.

Звёзды
310
Форки
34
Открытые issues
3
Последний коммит
16 часов назад

Что это?

iphone-use — это инструмент для самостоятельного хостинга, с помощью которого AI-агенты могут управлять настоящим iPhone. Демон на macOS считывает экран в виде дерева специальных возможностей (текст, а не пиксели), отправляет нажатия, ввод текста и свайпы через небольшой раннер XCTest, установленный на телефоне, а затем ждёт, пока экран перестанет меняться, прежде чем вернуть результат. Инструмент работает в любом приложении, в том числе без API, и управлять им можно через USB или Wi-Fi.

Агенты подключаются через MCP-сервер для Claude Code, Codex, Cursor, Claude Desktop и других MCP-клиентов либо через HTTP API. Для каждого действия сообщается, было ли оно выполнено; нажатия на перекрытые элементы отклоняются. Повторяющиеся задачи можно сохранять в виде flows, которые запускаются без модели. Тот же демон также предоставляет веб-страницу и нативное iOS-приложение, чтобы человек мог смотреть на экран в реальном времени и управлять устройством.

Для работы проекта нужны Mac с macOS 15 или новее, Xcode и iPhone с iOS 15 или новее и включённым Developer Mode. Лицензия — PolyForm Shield 1.0.0; она разрешает доступ к исходному коду, но не является стандартной лицензией open source.

Ключевые возможности

  • 01Считывает экран в виде текста из дерева специальных возможностей, без скриншотов.
  • 02Нажимает, вводит текст и свайпает в любом приложении, в том числе без API.
  • 03Подключается через USB или, после настройки, по Wi-Fi через зашифрованный туннель.
  • 04Предоставляет MCP-инструменты для Claude Code, Codex, Cursor и других MCP-клиентов, а также HTTP API.
  • 05Сохраняет повторяющиеся задачи в виде flows, которые запускаются без модели и токенов.
  • 06Предоставляет веб-страницу и нативное iOS-приложение для просмотра экрана в реальном времени и ручного управления.

Сценарии использования

  • Поручить Claude Code или Codex выполнять на телефоне многошаговые задачи, например читать данные приложений или отправлять сообщения.
  • Запускать на реальном iPhone тесты входа в систему или пользовательских сценариев и определять, на каком шаге возникает сбой.
  • Экспортировать данные из приложений без API, например приложений для здоровья или заметок.
  • Использовать один iPhone совместно с агентом и человеком, который при необходимости может вмешаться.

Быстрый старт

  1. 1

    Установите iphone-use на Mac с помощью скрипта установки

    curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh
  2. 2

    Проверьте, готов ли телефон к работе с агентами

    iphone-use doctor
  3. 3

    Запустите безвредную проверку, которая открывает «Настройки» и считывает экран

    iphone-use try

Что важно знать

  • Требуется Mac под управлением macOS 15 или новее с Xcode, а также iPhone с iOS 15 или новее и включённым Developer Mode.
  • Для первоначальной настройки нужен USB-кабель.
  • Лицензия — PolyForm Shield 1.0.0, которая ограничивает некоторые виды коммерческого использования; перед использованием ознакомьтесь с условиями.

Темы

Частые вопросы

Что такое iphone-use?
Позволяет AI-агентам, например Claude Code или Codex, считывать экран, нажимать, вводить текст и свайпать на реальном iPhone через USB или Wi-Fi с помощью MCP. iphone-use — это инструмент для самостоятельного хостинга, с помощью которого AI-агенты могут управлять настоящим iPhone. Демон на macOS считывает экран в виде дерева специальных возможностей (текст, а не пиксели), отправляет нажатия, ввод текста и свайпы через небольшой раннер XCTest, установленный на телефоне, а затем ждёт, пока экран перестанет меняться, прежде чем вернуть результат. Инструмент работает в любом приложении, в том числе без API, и управлять им можно через USB или Wi-Fi.
iphone-use можно использовать бесплатно? Какая у него лицензия?
iphone-use распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.
iphone-use всё ещё поддерживается?
Активно поддерживается. Последний коммит в iphone-use — 19 окт. 2026 г..
Для чего можно использовать iphone-use?
Поручить Claude Code или Codex выполнять на телефоне многошаговые задачи, например читать данные приложений или отправлять сообщения. Запускать на реальном iPhone тесты входа в систему или пользовательских сценариев и определять, на каком шаге возникает сбой. Экспортировать данные из приложений без API, например приложений для здоровья или заметок. Использовать один iPhone совместно с агентом и человеком, который при необходимости может вмешаться.
Как установить iphone-use?
Установите iphone-use на Mac с помощью скрипта установки: curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh Проверьте, готов ли телефон к работе с агентами: iphone-use doctor Запустите безвредную проверку, которая открывает «Настройки» и считывает экран: iphone-use try
Где скачать iphone-use?
Исходный код и инструкции по установке — на GitHub: https://github.com/leeguooooo/iphone-use

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты