Repolode
Enviar
leeguooooo

leeguooooo/iphone-use

Permite que agentes de IA, como Claude Code ou Codex, leiam a tela e toquem, digitem e deslizem em um iPhone real via USB ou Wi-Fi usando MCP.

Ver no GitHubSite
Estrelas
310
Forks
34
Issues abertas
3
Último commit
há 14 horas

O que é?

iphone-use é uma ferramenta self-hosted que permite que agentes de IA operem um iPhone real. Um daemon no macOS lê a tela como uma árvore de acessibilidade (texto, não pixels), envia toques, comandos de digitação e gestos de deslizar por meio de um pequeno runner XCTest instalado no telefone e aguarda a tela estabilizar antes de retornar um resultado. Funciona em qualquer app, inclusive naqueles que não oferecem API, e pode ser controlada via USB ou Wi-Fi.

Os agentes se conectam por um servidor MCP para Claude Code, Codex, Cursor, Claude Desktop e outros clientes MCP, ou por uma API HTTP. Cada ação informa se foi executada, e toques em elementos encobertos são recusados. Tarefas repetitivas podem ser salvas como flows, que são reproduzidos sem um modelo. O mesmo daemon também oferece uma página web e um app nativo para iOS para que uma pessoa veja a tela ao vivo e assuma o controle.

O projeto requer um Mac com macOS 15 ou posterior, Xcode e um iPhone com iOS 15 ou posterior e o Developer Mode ativado. É licenciado sob PolyForm Shield 1.0.0, uma licença que disponibiliza o código-fonte, mas não é uma licença padrão de código aberto.

Recursos principais

  • 01Lê o conteúdo da tela como texto a partir da árvore de acessibilidade, sem capturas de tela.
  • 02Toca, digita e desliza em qualquer app, inclusive naqueles sem API.
  • 03Conecta via USB ou, após a configuração, via Wi-Fi por meio de um túnel criptografado.
  • 04Disponibiliza ferramentas MCP para Claude Code, Codex, Cursor e outros clientes MCP, além de uma API HTTP.
  • 05Salva tarefas repetitivas como flows, que são reproduzidos sem modelo nem tokens.
  • 06Oferece uma página web e um app nativo para iOS para visualização ao vivo e controle manual.

Casos de uso

  • Permitir que Claude Code ou Codex executem tarefas com várias etapas no telefone, como ler dados de apps ou enviar mensagens.
  • Executar testes de login ou de fluxos em um iPhone real e informar em qual etapa ocorre uma falha.
  • Exportar dados de apps que não oferecem API, como apps de saúde ou de notas.
  • Compartilhar um iPhone entre um agente e uma pessoa que precise assumir o controle.

Início rápido

  1. 1

    Instale o iphone-use no Mac com o script de instalação

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

    Verifique se o telefone está pronto para os agentes

    iphone-use doctor
  3. 3

    Execute uma verificação inofensiva que abre os Ajustes e lê a tela

    iphone-use try

Antes de usar

  • Requer um Mac com macOS 15 ou posterior e Xcode, além de um iPhone com iOS 15 ou posterior e Developer Mode ativado.
  • A configuração inicial requer um cabo USB.
  • A licença é PolyForm Shield 1.0.0, que restringe alguns usos comerciais; consulte os termos antes de usar.

Tópicos

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

Perguntas frequentes

O que é iphone-use?
Permite que agentes de IA, como Claude Code ou Codex, leiam a tela e toquem, digitem e deslizem em um iPhone real via USB ou Wi-Fi usando MCP. iphone-use é uma ferramenta self-hosted que permite que agentes de IA operem um iPhone real. Um daemon no macOS lê a tela como uma árvore de acessibilidade (texto, não pixels), envia toques, comandos de digitação e gestos de deslizar por meio de um pequeno runner XCTest instalado no telefone e aguarda a tela estabilizar antes de retornar um resultado. Funciona em qualquer app, inclusive naqueles que não oferecem API, e pode ser controlada via USB ou Wi-Fi.
iphone-use é gratuito? Qual é a licença?
iphone-use é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
iphone-use ainda é mantido?
Manutenção ativa. O último commit de iphone-use foi em 19 de out. de 2026.
Para que posso usar iphone-use?
Permitir que Claude Code ou Codex executem tarefas com várias etapas no telefone, como ler dados de apps ou enviar mensagens. Executar testes de login ou de fluxos em um iPhone real e informar em qual etapa ocorre uma falha. Exportar dados de apps que não oferecem API, como apps de saúde ou de notas. Compartilhar um iPhone entre um agente e uma pessoa que precise assumir o controle.
Como instalar iphone-use?
Instale o iphone-use no Mac com o script de instalação: curl -fsSL https://raw.githubusercontent.com/leeguooooo/iphone-use/main/install.sh | sh Verifique se o telefone está pronto para os agentes: iphone-use doctor Execute uma verificação inofensiva que abre os Ajustes e lê a tela: iphone-use try
Onde consigo iphone-use?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/leeguooooo/iphone-use

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados