Dynaevangelical2652/android-agent

Controle dispositivos Android via ADB com este framework de automação em Python para execução de tarefas e escalonamento de farms de telefones.

O que é android-agent?

Este skill permite controlar dispositivos Android através do ADB (Android Debug Bridge) usando um framework de automação em Python. Ele é projetado para desenvolvedores e engenheiros de QA que precisam executar tarefas repetitivas em múltiplos dispositivos Android, como instalar/desinstalar aplicativos, capturar screenshots, executar comandos shell, simular toques e gestos, ou gerenciar farms de telefones em escala. O skill automatiza a comunicação com o ADB, eliminando a necessidade de scripts manuais complexos. Suporta qualquer plataforma que execute Python e tenha o ADB instalado (Windows, macOS, Linux). A integração com o agente permite que ele entenda comandos em linguagem natural e os traduza para ações ADB, facilitando o gerenciamento de dispositivos conectados via USB ou rede.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Dynaevangelical2652/android-agent

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que android-agent faz?

Controle dispositivos Android através do ADB com este framework de automação em Python para execução de tarefas e escalonamento de farms de telefones.

Descrição

Este skill fornece uma interface unificada para interagir com dispositivos Android via adb. Ele permite executar tarefas automatizadas como:

  • Instalar e desinstalar aplicativos
  • Capturar screenshots e gravar a tela
  • Executar comandos shell arbitrários
  • Simular toques, gestos e entrada de texto
  • Gerenciar múltiplos dispositivos simultaneamente (farms)

Como usar

Certifique-se de que o ADB está instalado e configurado no PATH do sistema. Conecte os dispositivos via USB ou rede.

Exemplo de uso:

from android_agent import AndroidAgent

agent = AndroidAgent()
devices = agent.list_devices()
for device in devices:
    device.install_apk("meu_app.apk")
    screenshot = device.take_screenshot()
    screenshot.save(f"screenshot_{device.serial}.png")

Requisitos

  • Python 3.8+
  • ADB (Android Debug Bridge) instalado e acessível via terminal
  • Dispositivo Android com depuração USB ativada

Comandos disponíveis

ComandoDescrição
list_devices()Lista todos os dispositivos conectados
install_apk(caminho)Instala um APK no dispositivo
take_screenshot()Captura a tela atual
shell(comando)Executa um comando shell
tap(x, y)Simula um toque nas coordenadas (x, y)

Licença

MIT

Habilidades Relacionadas