Ramus Android

Dê ao seu agente de codificação um aplicativo Android em execução para inspecionar. O CLI do Ramus pode iniciar um emulador, ler a tela, tocar, digitar e capturar evidências. Ele requer Node.js 22 ou posterior.

Comece com um teste

Execute estes comandos para abrir o aplicativo de demonstração sem uma conta:

npx ramus-cli trial
npx ramus-cli session start --demo --wait

Para testar sua própria compilação, substitua o segundo comando por:

npx ramus-cli session start --apk app-debug.apk --wait

O teste armazena uma chave temporária localmente e dura 60 minutos. Ele permite uma sessão ativa e APKs de até 150 MB. Visualizações do GitHub e túneis de desenvolvimento local exigem uma chave de API com login.

npx resolve o pacote no registro npm a cada invocação, o que adiciona cerca de 5 a 8 segundos por comando. Para uso repetido, instale-o uma vez com npm i -g ramus-cli e execute ramus diretamente; os comandos são idênticos caso contrário.

Abra o watchUrl retornado para acompanhar ou assumir o controle no seu navegador. Se estiver ausente, execute npx ramus-cli session share. Qualquer pessoa com este link pode operar o aplicativo, então compartilhe-o apenas com revisores pretendidos. Consulte Sessões de visualização para expiração e comportamento de reinicialização.

Verifique um fluxo

Observe Leia a tela.
Obtenha referências atualizadas.

Aja Toque, digite ou deslize
no que você encontrou.

Verifique Confira o resultado
em relação ao seu objetivo.

Observe novamente antes da próxima ação

Observe, aja, verifique. Leia um instantâneo e seus valores de ref/gen, aja com base nessa observação e depois verifique o resultado. Repita com referências atualizadas para a próxima ação. Um toque aceito por si só não prova que o fluxo funcionou.

Comece com uma observação:

npx ramus-cli snapshot

O resultado inclui elementos visíveis com identificadores ref e um contador gen. Use os valores desse resultado para sua próxima ação. Por exemplo, se ele mostrar um e3 clicável na geração 1:

npx ramus-cli tap e3 --gen 1 --expect "Welcome"

Substitua o texto esperado pelo resultado que você deseja verificar. Tire um novo instantâneo antes de escolher outra ação; referências antigas expiram após uma ação aceita ou um instantâneo posterior.

• Use type "hello" --ref <ref> --gen <gen> para focar um campo e inserir texto. Verifique o valor verified retornado e observe o resultado.
• Use wait --text "Welcome" para um estado específico, ou wait --stable após a navegação.
• Capture evidências com screenshot --out screen.jpg. Se a árvore da interface estiver incompleta, inspecione a captura de tela e use coordenadas normalizadas, como tap 0.5,0.72.
• Leia logcat --limit 200 após uma falha. Use app launch para retornar ao aplicativo.

Prefixe esses comandos com npx ramus-cli. Os comandos usam a sessão mais recente, a menos que você passe --session <id>. Encerre uma sessão com npx ramus-cli session end quando todos terminarem.

Conecte seu agente

Para usar um dispositivo já aberto na sua conta, escolha Conectar ao agente no cabeçalho da página do dispositivo. Configure uma chave de API da mesma conta no ambiente do seu agente e copie o Prompt do agente. Ele inclui o ID da sessão atual e comandos que inspecionam esse dispositivo. A aba MCP fornece a URL do servidor e instruções para um cliente MCP. Copiar instruções não conecta um agente; sua primeira observação bem-sucedida confirma a conexão.

Links de compartilhamento anônimos concedem apenas acesso ao navegador. Conectar-se por meio do CLI ou MCP exige uma chave de API pertencente ao proprietário do dispositivo.

Peça ao seu agente para ler ramus.dev/agents.md e depois forneça o caminho do APK e um fluxo específico para verificar. Peça que ele relate o que observou e inclua uma captura de tela e o link de observação quando disponível.

Para Claude Code, salve a habilidade android-use como .claude/skills/android-use/SKILL.md no seu projeto, ou clone-a de github.com/ramus-dev/android-use. Outros agentes podem usar o mesmo fluxo de trabalho por meio do CLI.

Clientes sem acesso ao shell podem usar o servidor MCP remoto em https://api.ramus.dev/api/mcp. Consulte a referência do agente para autenticação e ferramentas suportadas. Enviar um APK local e executar um túnel de desenvolvimento exigem o CLI.

Use sua conta

Crie uma chave de API em Configurações e defina RAMUS_API_KEY no ambiente onde seu CLI ou agente é executado. Mantenha a chave fora de chats e URLs. Execute npx ramus-cli status para verificar autenticação e sessões ativas.

Para uma compilação de visualização do GitHub pronta:

npx ramus-cli session start --pr owner/repo#123 --wait

Para trabalhar em alterações locais com Fast Refresh ou hot reload, continue para Desenvolvimento local.