Guia

Comande uma farm de celulares a partir de um único prompt

Monte celulares Android e iPhones reais em um Mac, pareie o host uma vez e opere toda a frota a partir de um prompt em linguagem natural para o BusyBro ou um cliente MCP — capturas de tela, toques, logins, automações — com uma confirmação em cada ação que muda alguma coisa.

Uma farm de celulares costumava significar uma sala cheia de dispositivos e uma pessoa andando entre eles. A farm do Busymate é um daemon host em um Mac com um hub USB alimentado: ele descobre cada celular conectado, espelha cada tela no seu navegador, expõe cada ação como uma ferramenta e se pareia como um dispositivo no seu dashboard, para que a frota apareça ao lado do seu próprio celular com saúde ao vivo. Como cada ação é uma ferramenta, um assistente de IA consegue operar um celular ou o rack inteiro a partir de uma frase.

Este guia vai de um hub vazio até essa frase. Ele é honesto sobre os limites: ações brutas de poder — shell, entrada arbitrária, instalação de apps fora da loja, alternância de rede, reinicializações — são só para administradores, sempre pedem confirmação e ficam totalmente fora do alcance do assistente de texto livre. O prompt comanda a superfície segura e curada, que é a maior parte do que uma rodada de testes precisa.

Antes de começar

O que você precisa

Hardware que você consiga plugar, um Mac para hospedá-lo e uma conta Busymate para ser dona dele.

  • Um Mac como host, mais um hub USB alimentado e cabos de dados — não cabos só de carregamento.

  • Celulares Android com a depuração USB ativada, e iPhones com o Modo Desenvolvedor ligado — os únicos toques no dispositivo que as plataformas exigem.

  • Uma conta Busymate com acesso de edição de dispositivos; o host e cada celular que ele provisiona pertencem a esse proprietário.

  • O BusyBro no dashboard, ou o Claude Code conectado via MCP — o guia anterior — como o lugar onde você digita o prompt.

Passo a passo

Faça na ordem

Montar, instalar, ver a frota aparecer, integrá-la e então entregá-la ao agente.

  1. 01

    Monte os celulares

    Conecte os celulares ao Mac pelo hub alimentado. Em cada Android, ative a depuração USB e toque em Permitir depuração USB quando o host pedir; essa é toda a configuração que um Android precisa. Em cada iPhone, ative o Modo Desenvolvedor e confie no host quando solicitado — os dois toques únicos que a Apple exige. Todo o resto do lado iOS é provisionado pelo daemon.

  2. 02

    Instale o daemon, faça login, inicie

    Uma linha instala o host da farm. Faça login uma vez no navegador para que o host possa parear — o daemon se recusa a iniciar sem login, então uma farm nunca roda sem dono por acidente — e depois inicie com autostart para que ele relance no login e na reinicialização. O comando de status mostra a build em execução, quantos celulares estão online e se o host está pareado.

    O host se pareia como um dispositivo Busymate com uma credencial de longa duração guardada em disco, então nunca mais precisa da sua sessão. Cada celular vira um dispositivo filho sob ele, com uma identidade estável que sobrevive a uma reconexão USB e herda a sua propriedade.

    Instalar, parear, iniciar, verificar
    bash
    curl -fsSL https://farm.busymate.net/install.sh | bash   # macOS / Linux
    bmfarm login                 # sign in once in the browser so the host can pair
    bmfarm start --autostart     # start the background daemon; relaunches at login
    bmfarm status                # running build, phones online / total, pairing state
  3. 03

    Veja a frota aparecer no dashboard

    Abra a visão Phone Farm no dashboard. A barra lateral tem uma entrada Daemon — o painel no nível da farm, com um painel de controle por máquina e um log ao vivo transmitido do host — e uma entrada por máquina da farm, abrindo os celulares Android e iOS daquele Mac. Cada celular mostra modelo, versão do SO, bateria e estado, e um espelho ao vivo: a tela é transmitida como vídeo e decodificada por hardware no seu navegador, e seus toques, deslizes e teclas vão até o dispositivo físico. A recuperação após um reinício do daemon é guiada por heartbeat, então não há nada para atualizar.

  4. 04

    Integre todos os celulares com uma ação

    Cada celular precisa de alguns componentes atualizados — o runner de controle no dispositivo, a confiança no certificado, o app Busymate DevTools para captura, e assim por diante. Em vez de percorrer o rack, a ação Onboard all phones no card do host faz a varredura da frota por você, com isolamento por celular para que uma instalação que falha nunca aborte a varredura. O dashboard mostra uma grade ao vivo de celulares por componentes; uma célula só fica verde quando o daemon confirma a versão instalada, um componente já atualizado é um pulo esmaecido, e qualquer coisa que precise de um humano — um aviso de Apple ID, um app pago — é sinalizada em vez de forjada.

  5. 05

    Conecte o agente

    Duas portas levam às mesmas ferramentas. O BusyBro está embutido no dashboard e no app BusyBro independente, já logado como você. O Claude Code — ou qualquer cliente MCP — se conecta ao mesmo servidor com um comando e um login no navegador, coberto no guia anterior. De qualquer forma, o assistente age como você: cada ferramenta da farm é limitada aos seus próprios dispositivos de farm, depende do opt-in de controle remoto do host e é checada contra as capacidades do seu papel.

  6. 06

    Escreva o único prompt

    Diga o que quer que seja feito em toda a frota, em linguagem natural. O assistente lista os celulares online, captura a tela de cada um, abre o app, encontra e toca nos elementos de que precisa lendo a hierarquia da interface, digita o login e reporta celular por celular. Variáveis que você define no console da farm — uma conta de teste, um código de cupom — ficam disponíveis para as automações por nome, então o prompt nunca precisa conter uma senha.

    Qualquer coisa que altere um celular mostra primeiro um card de confirmação — com o payload completo do que está prestes a rodar — e espera. Uma captura de tela ou um dump da interface não precisa de confirmação; um toque, uma instalação da loja pública ou a execução de uma automação precisam. Shell bruto, ADB bruto, entrada arbitrária, alternância de proxy e modo avião e reinicializações são ações de poder só para administradores que o assistente de texto livre não consegue alcançar; elas ficam no dashboard e nas ferramentas MCP atrás de uma confirmação explícita.

    Um prompt, o rack inteiro
    text
    On every online farm phone: take a screenshot, open the checkout app, sign in with the test-account variables, and tell me which phones show the new "Pay in 3" button. Flag any phone whose screen is black.
  7. 07

    Faça repetir, e capture o que os celulares enviam

    Automações são arquivos JavaScript simples no host com uma API de dispositivo — instalar, abrir, encontrar e tocar, digitar, capturar tela — e um agendador que as roda em intervalos. Peça ao assistente para agendar uma e ela vira um job noturno com resultados por dispositivo. O tráfego dos celulares da farm passa pelo proxy compartilhado para o mesmo feed do seu próprio celular, então a atividade de rede de uma rodada é inspecionável, mockável e exportável como qualquer outra captura; celulares Android da farm rodam no nível com root, onde o certificado fica no repositório do sistema, o que descriptografa tudo exceto um app que faz pinning.

    A saúde da frota também é uma ferramenta: pergunte quais celulares precisam de atenção e o assistente lê o mesmo heartbeat que o dashboard mostra e pode disparar a varredura de auto-reparo — de novo, atrás de uma confirmação.

    Transforme a rodada em um job noturno
    text
    Run the login-smoke automation on all Android farm phones every night at 02:00 and message me only if a phone fails.

Solução de problemas

O que pode dar errado

Problemas na farm são quase sempre um cabo, um toque no celular ou uma proteção fazendo o seu trabalho.

  • Um celular nunca aparece na frota

    Nove em dez vezes é um cabo só de carregamento ou um aviso de Permitir depuração USB não respondido no Android. Troque o cabo, desbloqueie o celular e aceite o aviso. No iOS, confirme que o Modo Desenvolvedor está ligado e que o host é confiável.

  • O daemon se recusa a iniciar

    Ele falha rápido até que o host tenha um dono. Rode o comando de login, entre e inicie de novo — o comando de status confirma o pareamento.

  • O bloco do espelho está preto

    O celular está bloqueado, a tela está desligada ou o runner de controle ainda não está armado. Acorde o celular; se continuar preto, rode a ação de integração para aquele celular para que seus componentes sejam rechecados com evidência real.

  • O assistente diz que não pode rodar um comando de shell

    Correto e intencional: shell bruto, ADB bruto e as outras ações de poder são só para administradores e vedadas ao assistente de texto livre. Use o console do dashboard ou a ferramenta MCP diretamente, onde a confirmação explícita se aplica.

  • Uma ação foi negada para um celular que eu consigo ver

    Ações da farm são limitadas aos seus próprios dispositivos de farm e precisam do opt-in de controle remoto do host mais acesso de edição de dispositivos no seu papel. Verifique o opt-in do host nas configurações dele e as capacidades do seu papel.

Perguntas frequentes

Perguntas que as pessoas fazem

Isso é celular na nuvem ou emulador?

Nenhum dos dois. São celulares físicos em um hub plugado em uma máquina que você controla. Você também pode alugar uma frota gerenciada em vez de montar a sua — a página de preços cobre isso.

O assistente pode realmente quebrar um celular?

A superfície destrutiva é só para administradores, exige confirmação e fica fora do prompt de texto livre. O que o prompt pode fazer — capturas de tela, toques, abrir apps, instalações da loja, automações — sempre mostra a ação exata antes de rodar.

A captura de tráfego funciona nos celulares da farm?

Sim. Os celulares da farm passam pelo proxy compartilhado para o mesmo feed do dashboard que qualquer outro dispositivo, e os Android com root da farm descriptografam todo o sistema, exceto certificate pinning.

Um rack de celulares reais, a uma frase de distância

Plugue-os, pareie o host e deixe o assistente operar a frota — com você aprovando cada mudança.

Ask your mate