O que é agent-device?
O agent-device dá a um agente de código mãos e olhos sobre um app em execução. O agente tira um snapshot da árvore de acessibilidade do app, recebe referências curtas como @e2 para cada botão e campo, e então toca, preenche, rola e faz verificações sobre elas, recorrendo a capturas de tela e coordenadas quando os dados de acessibilidade do app são fracos. Ele cobre simuladores, emuladores e aparelhos físicos iOS e Android, HarmonyOS, tvOS, Android TV, Fire TV, Amazon Vega OS, web, macOS e Linux, com profundidade variando conforme o alvo.
O mesmo runtime é exposto de três formas: uma CLI, um servidor MCP via stdio iniciado com agent-device mcp e um cliente Node.js tipado. As execuções podem ser salvas como scripts .ad, repetidas no CI e exportadas como YAML do Maestro, e as sessões ficam ligadas à git worktree de quem chama, para que agentes em paralelo não peguem os simuladores uns dos outros. Aparelhos hospedados na BrowserStack, no AWS Device Farm, na TestMu AI e na Limrun usam os mesmos comandos.
É feito pela Callstack, a consultoria de React Native, sob a licença MIT. O repositório foi criado em janeiro de 2026; a v0.21.36 saiu em 2 de novembro de 2026.
agent-device vale a pena?
O agent-device fecha o ciclo que os agentes de código deixam aberto no mobile: eles conseguem escrever uma tela, mas não conseguem vê-la. Ele faz isso como o agent-browser da Vercel faz para a web, entregando ao agente um snapshot de acessibilidade compacto com referências estáveis em vez de pedir a um modelo que raciocine sobre capturas de tela. Isso mantém cada passo barato em tokens e determinístico o bastante para ser gravado, e não há nenhum modelo dentro da ferramenta.
O que o separa dos muitos pequenos servidores MCP mobile é a estrutura em volta do snapshot. As sessões ficam restritas a uma git worktree e os aparelhos são reivindicados por host, então dois agentes em duas worktrees não disputam um simulador, e agent-device device release --stale libera reivindicações cujo dono morreu. Uma execução que o agente resolve uma vez pode ser salva como script .ad e repetida no CI ou exportada para o Maestro. O relato da Expensify mostra o resultado: uma skill interna lê os passos de reprodução de um bug, resolve-os uma vez e depois repete o script para gravar vídeos de antes e depois em cada plataforma para o pull request, um trabalho que a equipe estimou em cinco minutos por plataforma à mão, em centenas de issues.
O modelo de segurança é documentado com cuidado. O daemon escuta só em 127.0.0.1 em portas efêmeras, cada requisição exige um token novo de 24 bytes guardado em um arquivo 0600, e o servidor MCP nunca expõe um shell genérico. A documentação é igualmente clara sobre os riscos: a ferramenta pode operar qualquer aparelho e app desktop que a sua conta de usuário alcança, capturas de tela, logs e capturas de rede podem conter credenciais, e o texto digitado pode vazar para os logs do XCTest no iOS. Links de artefatos na nuvem devem ser tratados como segredos.
O custo é a amplitude e a mudança constante. 108 issues e pull requests abertos, uma versão 0.x e lançamentos frequentes significam que os comandos ainda mudam, e o suporte diminui no HarmonyOS e no Vega OS, que cobrem só parte dos comandos. O MCP também não tem alguns fluxos da CLI, como a conexão com nuvens de aparelhos e a configuração para web, e a documentação ainda recomenda a CLI para execuções longas ou manuais no Claude Code. Para uma suíte de regressão estável, a própria Callstack indica um framework de testes convencional; o agent-device serve para as verificações exploratórias que um agente faz enquanto trabalha, e que ele depois deixa você guardar.
Onde ele se destaca
Um desenvolvedor React Native em uma equipe de produto de 10 pessoas que usa Claude Code
Fazer o agente construir uma tela e provar que ela funciona nas duas plataformas
Instale a CLI, rode agent-device doctor e peça ao agente que implemente a tela, abra-a no simulador iOS e no emulador Android e anexe capturas de tela. Gratuito; a primeira execução no iOS é mais lenta enquanto o runner da Apple é compilado.
Um líder de QA em uma empresa com centenas de bugs mobile abertos, como a Expensify
Anexar gravações de antes e depois a cada pull request de correção
Um agente percorre os passos de reprodução uma vez, salva-os como script .ad e o repete em cada plataforma para gravar MP4s, o que a Expensify estimou substituir cerca de cinco minutos de captura manual por plataforma.
Um engenheiro de plataforma rodando verificações mobile no CI em runners Linux
Repetir fluxos gravados por agentes em aparelhos reais sem um laboratório de aparelhos
Defina credenciais da BrowserStack, do AWS Device Farm ou da Limrun como segredos do CI e rode os scripts salvos em aparelhos hospedados; o provedor cobra o tempo de aparelho, e links de artefatos devem ser tratados como segredos.
Antes de decidir
- Configuração
- npm install -g agent-device@latest no Node.js 22.12 ou mais recente (24 para web), depois agent-device doctor. O iOS exige Xcode, o Android exige o SDK e o ADB; aparelhos iOS físicos exigem o Developer Mode e um runner assinado. Adicione o servidor MCP com o comando agent-device e o argumento mcp.
- Integrações
- CLI, servidor MCP via stdio que espelha os comandos instalados mais uma ferramenta de ajuda, e um cliente Node.js tipado com guias para AI SDK e Eve. Nuvens de aparelhos: BrowserStack, AWS Device Farm e Limrun nativos, TestMu AI e Revyl como plugins. Exporta YAML do Maestro; um template de workflow EAS cobre o CI do Expo.
- Dados e privacidade
- Roda localmente; o daemon escuta em 127.0.0.1 com um token de 24 bytes gerado a cada início. A única chamada externa por padrão é uma verificação de atualização do npm, desligada com AGENT_DEVICE_NO_UPDATE_NOTIFIER=1. Capturas de tela, logs e dumps de rede podem conter segredos; os provedores de nuvem guardam os próprios artefatos.
- Custo em escala
- A ferramenta é gratuita; o uso local custa só um Mac para iOS. Aparelhos hospedados são cobrados pela BrowserStack, pelo AWS Device Farm, pela TestMu AI ou pela Limrun a preços próprios, que a documentação não lista; a Callstack oferece serviços de QA para equipes sob consulta, com preço não publicado.
- Limites
- Sessões remotas exigem um nome de sessão; só a Limrun suporta port reverse e dumps de rede ao vivo; Limrun e Revyl não guardam artefatos depois do encerramento; o MCP não consegue conectar nem desconectar provedores de nuvem.
O que é bom
- Snapshots de acessibilidade com referências em vez de raciocínio sobre capturas de tela
- Sessões por worktree impedem que agentes em paralelo dividam um simulador
- Grave uma vez como scripts .ad, repita no CI ou exporte para o Maestro
- Daemon só em loopback com tokens a cada início; sem shell via MCP
O que não é
- Versões 0.x com 108 issues e pull requests abertos
- HarmonyOS e Vega OS cobrem só parte dos comandos
- Alguns fluxos, como a conexão com a nuvem, são só pela CLI
- Rótulos de acessibilidade fracos no app significam execuções menos confiáveis
Ideal para
Equipes de mobile e React Native que querem que agentes de código verifiquem as próprias mudanças em simuladores, aparelhos ou uma nuvem de aparelhos e anexem as evidências aos pull requests.
agent-device: perguntas frequentes
- agent-device vale a pena?
- Se os seus agentes escrevem código mobile, o agent-device é como eles conferem que ele roda, e já tem a gestão de aparelhos e a repetição no CI que faltam aos servidores MCP mobile avulsos. Damos nota 4.3 de 5.
- Quanto custa agent-device?
- Gratuito sob a licença MIT; as nuvens de aparelhos são cobradas pelos seus provedores, e a Callstack vende serviços de QA para equipes sob consulta.
- Quais são as desvantagens de agent-device?
- Versões 0.x com 108 issues e pull requests abertos; harmonyOS e Vega OS cobrem só parte dos comandos; alguns fluxos, como a conexão com a nuvem, são só pela CLI; rótulos de acessibilidade fracos no app significam execuções menos confiáveis.
- Para quem agent-device é indicado?
- Equipes de mobile e React Native que querem que agentes de código verifiquem as próprias mudanças em simuladores, aparelhos ou uma nuvem de aparelhos e anexem as evidências aos pull requests.
- Quanto custa agent-device para uma equipe ou em produção?
- A ferramenta é gratuita; o uso local custa só um Mac para iOS. Aparelhos hospedados são cobrados pela BrowserStack, pelo AWS Device Farm, pela TestMu AI ou pela Limrun a preços próprios, que a documentação não lista; a Callstack oferece serviços de QA para equipes sob consulta, com preço não publicado.
- agent-device é seguro para dados da empresa?
- Roda localmente; o daemon escuta em 127.0.0.1 com um token de 24 bytes gerado a cada início. A única chamada externa por padrão é uma verificação de atualização do npm, desligada com AGENT_DEVICE_NO_UPDATE_NOTIFIER=1. Capturas de tela, logs e dumps de rede podem conter segredos; os provedores de nuvem guardam os próprios artefatos.
Respostas verificadas em 5 de nov. de 2026.
Você faz o agent-device? Mostre esta nota no seu site
