O que é phone-harness?
O phone-harness deixa um agente de código usar um celular como uma pessoa usaria. O agente escreve scripts curtos em Python com funções auxiliares já importadas, como open_app, tap_text, type_text e screen, e a CLI os executa. Um iPhone é controlado pela janela do Espelhamento do iPhone num Mac, lido com o OCR Vision da Apple e operado com eventos de entrada sintéticos; um Android é controlado por adb, com o texto da sua árvore de acessibilidade. Nada é instalado no celular e não é preciso jailbreak.
As mesmas funções controlam celulares do Phone Harness Cloud, o serviço pago da empresa: emuladores Android via adb e iPhones reais dedicados via HTTPS, com visualização ao vivo no navegador. Um servidor MCP hospedado cobre só os celulares na nuvem, e há plugins para Hermes Agent e OpenClaw. O agente pode salvar suas próprias funções numa pasta de trabalho que sobrevive às atualizações.
A CLI tem licença MIT e a empresa diz ter apoio da Y Combinator. O repositório foi criado em agosto de 2026; a versão 0.3.3 saiu em 2 de novembro de 2026.
phone-harness vale a pena?
O phone-harness resolve bem um problema estreito: a maioria das ferramentas de celular para agentes exige Xcode, um build de teste ou um app no aparelho, e esta controla o iPhone que já está no seu bolso pelo Espelhamento do iPhone do macOS. O custo desse atalho é ler a tela por OCR. Ele vê texto, não ícones, então botões sem rótulo exigem uma captura e um modelo com visão, e não há multitoque, câmera nem Face ID. O Android pisa em terreno mais firme, com entrada por adb e a árvore de acessibilidade.
Tenha claro o acesso de que ele precisa. Num Mac, o terminal ou o app do agente que o executa precisa das permissões de Acessibilidade e Gravação de Tela, o que deixa esse app ler a tela inteira e enviar teclas a qualquer janela, não só ao celular. No Android, a depuração por USB ou sem fio dá ao computador controle total do aparelho. Depois, o agente roda Python que ele mesmo escreve, sem etapa de aprovação antes de uma compra ou mensagem; a própria demo do README mostra um agente pedindo uma corrida de Waymo. O pinky, ao contrário, segura toques arriscados até você aprovar.
A telemetria é o ponto em que agir. A menos que DO_NOT_TRACK=1 ou phone-harness config set telemetry false esteja definido, cada chamada da CLI envia ao PostHog um evento com o script (até 20.000 caracteres) e os últimos 20.000 caracteres da saída, muitas vezes texto lido da tela do seu celular. Depois que você entra na nuvem, esses eventos ficam ligados à sua conta. O guia de instalação menciona a chave num parágrafo; o README, não.
O código é pequeno, cerca de 8.600 linhas de Python de cinco colaboradores, diante de 5.328 estrelas, e o repositório serve também de porta de entrada para uma nuvem paga que o README promove do começo ao fim. Os preços da nuvem são claros: emuladores Android a 5¢ o minuto ou 1.000 minutos por $20 ao mês, e iPhones reais a partir de $80 ao mês com preço fixo, reservados com depósito de $20. Para testar apps, o agent-device é a ferramenta mais completa; o phone-harness é para controlar o seu próprio celular.
Onde ele se destaca
Um desenvolvedor com Mac e um iPhone no iOS 18
Fazer o Claude Code checar toda manhã uma tela de status de um app no celular
Instale com uv, registre a skill, pareie o Espelhamento do iPhone e dê ao terminal as permissões de Acessibilidade e Gravação de Tela, desligue a telemetria e deixe o agente rodar um script curto com open_app e screen. Gratuito no seu próprio hardware.
Um engenheiro de QA numa startup de cinco pessoas sem laboratório de aparelhos
Fazer um agente percorrer o cadastro de um app Android num celular limpo
phone-harness cloud start entrega um emulador Android novo por 15 minutos por padrão; o agente o controla por adb e você acompanha ao vivo. A 5¢ o minuto, uma sessão de 15 minutos custa 75¢ do crédito inicial de $5.
Uma equipe de growth que precisa de um iPhone real com número próprio
Deixar um agente concluir fluxos de apps que pedem códigos por SMS
Reserve um iPhone na nuvem com eSIM pelo comando cloud reserve e um depósito reembolsável de $20; depois ele custa um valor fixo de $100 ao mês pelo preço de tabela, controlado via HTTPS de qualquer sistema.
Antes de decidir
- Configuração
- uv tool install phone-harness com Python 3.12, depois registre a saída de phone-harness skill no seu agente. O iPhone exige macOS 15+, Espelhamento do iPhone pareado com iOS 18+ e duas permissões do macOS; o Android exige adb e depuração por USB ou sem fio. phone-harness doctor aponta o primeiro passo que falta.
- Integrações
- Skill de agente para Claude Code, Codex e outros; um servidor MCP hospedado em mcp.phone-harness.com só para celulares na nuvem; plugins para Hermes Agent e OpenClaw; uma API HTTP para os celulares na nuvem.
- Dados e privacidade
- O controle local fica na sua máquina, mas a telemetria do PostHog, ativa por padrão, envia cada script e até 20.000 caracteres de saída, ligados à sua conta na nuvem após o login; desliga com DO_NOT_TRACK=1. Desligada por padrão no Hermes. Um Android salvo na nuvem mantém apps e logins no provedor.
- Custo em escala
- O uso local é gratuito. O Cloud Android Basic custa 5¢ por minuto de celular; o Plus, $20/mês com 1.000 minutos e depois 4¢. Um iPhone real custa $80/mês de tabela ($100 com eSIM), $64 ao mês no plano anual; frotas maiores sob consulta.
- Cancelamento e reembolso
- Reservas na nuvem podem ser canceladas pela CLI e o depósito volta ao cartão que pagou até o celular ser entregue; depois disso, ele é abatido da primeira fatura e deixa de ser reembolsável. As regras de reembolso das assinaturas ficam numa página separada que não verificamos.
- Limites
- Desbloquear o iPhone pausa o espelhamento; um Android com PIN precisa de você; vídeo com DRM aparece preto; cinco reservas não pagas por hora e conta; o servidor MCP não alcança celulares locais.
O que é bom
- Controla um iPhone pessoal sem Xcode, jailbreak ou app no celular
- As mesmas funções para iPhone, Android e celulares na nuvem
- O agente mantém sua própria biblioteca de funções entre atualizações
- Preços de nuvem claros, por minuto e fixos
O que não é
- Telemetria ativa por padrão envia scripts e texto da tela ao PostHog
- As permissões do Mac dão ao app do agente controle da tela inteira
- O OCR só vê texto; sem ícones, multitoque ou Face ID
- Sem etapa de aprovação antes de compras ou mensagens
Ideal para
Desenvolvedores que querem que um agente faça tarefas ou verificações no próprio iPhone ou Android, ou num celular alugado na nuvem, e que vão desligar a telemetria antes.
Alternativas ao phone-harness
phone-harness: perguntas frequentes
- phone-harness vale a pena?
- O phone-harness leva um agente até o seu próprio iPhone com menos esforço do que qualquer outra coisa que já analisamos, mas por padrão envia seus scripts e o texto da tela para análise de uso, então desligue a telemetria antes de usá-lo num celular pessoal. Damos nota 3.4 de 5.
- Quanto custa phone-harness?
- CLI gratuita sob MIT. Nuvem: Android a 5¢ por minuto de celular com $5 de crédito inicial, ou Plus a $20/mês por 1.000 minutos; iPhones reais a partir de $80/mês ($50 por um primeiro celular no momento em que escrevemos).
- Quais são as desvantagens de phone-harness?
- Telemetria ativa por padrão envia scripts e texto da tela ao PostHog; as permissões do Mac dão ao app do agente controle da tela inteira; o OCR só vê texto; sem ícones, multitoque ou Face ID; sem etapa de aprovação antes de compras ou mensagens.
- Para quem phone-harness é indicado?
- Desenvolvedores que querem que um agente faça tarefas ou verificações no próprio iPhone ou Android, ou num celular alugado na nuvem, e que vão desligar a telemetria antes.
- Quanto custa phone-harness para uma equipe ou em produção?
- O uso local é gratuito. O Cloud Android Basic custa 5¢ por minuto de celular; o Plus, $20/mês com 1.000 minutos e depois 4¢. Um iPhone real custa $80/mês de tabela ($100 com eSIM), $64 ao mês no plano anual; frotas maiores sob consulta.
- phone-harness é seguro para dados da empresa?
- O controle local fica na sua máquina, mas a telemetria do PostHog, ativa por padrão, envia cada script e até 20.000 caracteres de saída, ligados à sua conta na nuvem após o login; desliga com DO_NOT_TRACK=1. Desligada por padrão no Hermes. Um Android salvo na nuvem mantém apps e logins no provedor.
- Como cancelo o phone-harness e consigo reembolso?
- Reservas na nuvem podem ser canceladas pela CLI e o depósito volta ao cartão que pagou até o celular ser entregue; depois disso, ele é abatido da primeira fatura e deixa de ser reembolsável. As regras de reembolso das assinaturas ficam numa página separada que não verificamos.
- Quais são as melhores alternativas ao phone-harness?
- As alternativas mais próximas que analisamos são agent-device, Pinky e Droidline.
Respostas verificadas em 20 de nov. de 2026.