Sobre o projeto

O Phone Harness é uma ferramenta que conecta agentes de programação, como Claude Code ou Codex, a um telefone real. Ele oferece suporte ao iPhone por meio da janela de Espelhamento do iPhone no Mac e ao Android via adb no macOS, Linux ou Windows. Não é necessário jailbreak, Xcode nem software instalado no telefone. O agente pode ver a tela, encontrar texto com coordenadas prontas para toque, tocar, deslizar, digitar e ler o resultado. Um prompt de configuração permite que o agente clone e instale a ferramenta, registre-a como uma skill de agente e guie o usuário pelas etapas de pareamento. Um comando `--doctor` verifica a cadeia de conexão. Para iPhone, o harness captura a janela de espelhamento, realiza OCR com o framework Vision da Apple e envia eventos em nível de HID para toques, deslizes e digitação. Para Android, ele usa adb com `screencap` para captura, a árvore de acessibilidade para texto e `input` para ações via USB ou Wi-Fi. Os mesmos helpers funcionam nas duas plataformas. Uma opção em nuvem fornece telefones Android hospedados acessíveis via adb, com apps e logins persistentes, e os primeiros 100 minutos gratuitos. Os limites documentados incluem ausência de multitoque, ausência de fluxos de câmera ou Face ID, renderização de vídeo com DRM em preto, e o usuário deve cuidar do desbloqueio e da conexão do telefone.