Repolode
Enviar
leeguooooo

leeguooooo/iphone-use

Permite que agentes de IA como Claude Code o Codex lean la pantalla, toquen, escriban y deslicen en un iPhone real por USB o Wi-Fi mediante MCP.

Ver en GitHubSitio web
Estrellas
310
Forks
34
Issues abiertos
3
Último commit
hace 2 horas

¿Qué es?

iphone-use es una herramienta autohospedada que permite a agentes de IA manejar un iPhone real. Un daemon en macOS lee la pantalla como un árbol de accesibilidad (texto, no píxeles), envía toques, texto y deslizamientos mediante un pequeño runner de XCTest instalado en el teléfono y espera a que la pantalla se estabilice antes de devolver un resultado. Funciona en cualquier app, incluidas las que no exponen una API, y se puede controlar por USB o Wi-Fi.

Los agentes se conectan a través de un servidor MCP para Claude Code, Codex, Cursor, Claude Desktop y otros clientes MCP, o mediante una API HTTP. Cada acción indica si se aplicó, y se rechazan los toques en elementos cubiertos. Las tareas repetitivas se pueden guardar como flujos que se reproducen sin un modelo. El mismo daemon también ofrece una página web y una app nativa de iOS para que una persona vea la pantalla en directo y tome el control.

El proyecto requiere una Mac con macOS 15 o posterior, Xcode y un iPhone con iOS 15 o posterior y el Modo de desarrollador activado. Su licencia es PolyForm Shield 1.0.0, que permite acceder al código fuente, pero no es una licencia de código abierto estándar.

Funciones clave

  • 01Lee la pantalla como texto a partir del árbol de accesibilidad, sin capturas de pantalla.
  • 02Toca, escribe y desliza en cualquier app, incluidas las que no tienen API.
  • 03Se conecta por USB o, tras la configuración, por Wi-Fi mediante un túnel cifrado.
  • 04Ofrece herramientas MCP para Claude Code, Codex, Cursor y otros clientes MCP, además de una API HTTP.
  • 05Guarda tareas repetitivas como flujos que se reproducen sin un modelo ni tokens.
  • 06Ofrece una página web y una app nativa de iOS para ver la pantalla en directo y controlarla manualmente.

Casos de uso

  • Permitir que Claude Code o Codex realicen tareas de varios pasos en un teléfono, como leer datos de una app o enviar mensajes.
  • Ejecutar pruebas de inicio de sesión o de flujos en un iPhone real e informar qué paso falla.
  • Exportar datos de apps que no ofrecen una API, como las de salud o notas.
  • Compartir un iPhone entre un agente y una persona que necesite intervenir.

Temas

#ai-agent#mcp#ios-automation#iphone#mobile-automation#claude-code#xcuitest#automation#codex#computer-use

Preguntas frecuentes

¿Qué es iphone-use?
Permite que agentes de IA como Claude Code o Codex lean la pantalla, toquen, escriban y deslicen en un iPhone real por USB o Wi-Fi mediante MCP. iphone-use es una herramienta autohospedada que permite a agentes de IA manejar un iPhone real. Un daemon en macOS lee la pantalla como un árbol de accesibilidad (texto, no píxeles), envía toques, texto y deslizamientos mediante un pequeño runner de XCTest instalado en el teléfono y espera a que la pantalla se estabilice antes de devolver un resultado. Funciona en cualquier app, incluidas las que no exponen una API, y se puede controlar por USB o Wi-Fi.
¿iphone-use es gratuito? ¿Qué licencia tiene?
iphone-use es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿iphone-use sigue mantenido?
Mantenimiento activo. El último commit de iphone-use fue el 19 oct 2026.
¿Para qué puedo usar iphone-use?
Permitir que Claude Code o Codex realicen tareas de varios pasos en un teléfono, como leer datos de una app o enviar mensajes. Ejecutar pruebas de inicio de sesión o de flujos en un iPhone real e informar qué paso falla. Exportar datos de apps que no ofrecen una API, como las de salud o notas. Compartir un iPhone entre un agente y una persona que necesite intervenir.
¿Dónde consigo iphone-use?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/leeguooooo/iphone-use

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados