Instalar QuickAgent
Escolha o sistema do dispositivo que receberá o agente.
Instalar no Windows
O instalador baixa o EXE com SHA-256 verificado e abre a configuração. Terminal e Tela já estão no executável.
Instalar no Linux
Confira com uname -m. O instalador detecta a arquitetura do dispositivo.
Instalar no Android
Instalar e conectar
- Baixe e abra o APK no celular. Se solicitado, permita instalar apps dessa fonte.
- Abra o QuickAgent, informe seu usuário QuickAgent e um alias. A conta deve existir; o agente não pede a senha.
- Permita notificações e toque em Iniciar agente. Confira o dispositivo no painel da sua conta.
Permissões
Use os botões do QuickAgent para abrir cada autorização do Android.
Acessibilidade bloqueada ou agente encerrando sozinho
Em Android 13+, se aparecer “Configuração restrita”, abra Configurações → Apps → QuickAgent → ⋮ → Permitir configurações restritas. Depois habilite Acessibilidade. Os nomes variam por fabricante. Orientação Android.
Nas opções do app, permita execução em segundo plano e inicialização automática. No Xiaomi/MIUI/HyperOS, confira bateria Sem restrições e janelas em segundo plano. Não force a parada do app se quiser receber conexões.
Shizuku opcional: acesso ADB
O agente já funciona sem Shizuku. Para comandos com permissões ADB, instale o Shizuku oficial, inicie seu serviço e toque em Autorizar Shizuku no QuickAgent.
Android 11+ permite iniciar por depuração sem fio no próprio celular. Sem root, é necessário iniciar o Shizuku novamente após reiniciar. Isso é separado da inicialização do QuickAgent. Guia Shizuku.
Instalar por USB / ADB
Com depuração USB autorizada, no computador:
adb install -r QuickAgent.apkTambém é possível instalar o APK sobre o app existente; mantenha os dados. Se houver conflito de assinatura com um piloto antigo, avise antes de desinstalar.
Se o Android exigir verificação de desenvolvedor, confira o fluxo oficial para apps não verificados. ADB continua sendo uma alternativa de instalação.
Atualizar
A partir da 0.10.3, use Atualizar Agente no portal ou Verificar atualização no app, mesmo com o agente parado. A opção Atualizações automáticas começa desligada; se você a ativar no aparelho e permitir instalações desta fonte no Android, o agente verifica novas versões periodicamente. O Android ainda pode pedir confirmação em alguma atualização. Não exige Shizuku ou root.
O APK é verificado por SHA-256, pacote, versão e assinatura. A conta e as configurações são preservadas. Se o agente estava ligado, ele reconecta; a opção de iniciar com o Android não muda. Versões anteriores precisam instalar o APK atual uma vez para receber o atualizador.
Compatibilidade e testes
Controle validado no Redmi Note 10S com Android 13 / MIUI 14 e em emulador Android 13. No Android 16, instalação, interface, shell e leitura da UI foram confirmados; a interação de tela ainda está em validação. Android 11 é o mínimo declarado, ainda sem teste completo. Outros fabricantes estão em validação; a base usa APIs padrão do Android e anuncia só as permissões disponíveis.
Telas protegidas, desbloqueio por senha e dados privados de outros apps continuam sujeitos às restrições do Android. Não requer root ou Google Play Services. Sem vídeo ao vivo ou túneis nesta versão.
Ao reportar um problema, envie modelo, fabricante, versão do Android/MIUI/One UI etc., versão do agente, permissões ativas e o trecho relevante da Caixa de Logs. Confira conexão com tela apagada e Wi-Fi/dados móveis; reinício apenas se quiser testar a inicialização automática.
QuickAgent para macOS
Disponível em breve
Os clientes para Apple Silicon (série M) e Intel estão atualmente em desenvolvimento.
- Informe seu usuário QuickAgent acima, copie o comando e execute no dispositivo.
Download direto e licenças
Para abrir manualmente: baixe o EXE e escolha “Executar como administrador” no menu de contexto, ou abra normalmente para usar sem elevação.
Bibliotecas de vídeo e áudio: licenças e código-fonte, para consulta e recompilação; não é necessário baixar para instalar.
O binário isolado oferece Terminal. Para interface e Tela, use o instalador acima com a opção de interface gráfica.
O componente de Tela X11 usa x11vnc e bibliotecas de terceiros. Código-fonte e licenças, para consulta e recompilação; não é necessário baixar para instalar.
Como Desinstalar
Documentação do ADB. Se houver vários aparelhos conectados, selecione o correto com adb -s SERIAL.