Google Antigravity Remote Control: como controlar o agente a partir do telemóvel
MarkdownComo ativar o Remote Control no Google Antigravity no computador e na CLI: o interruptor, o daemon agy remote-control e o que fazer se tiver problemas de ligação.
Ler o artigo completo
Documentação do Ailoot — materiais de referência sobre a utilização do serviço.
Destaques
No Antigravity 2.0 para computador, o Remote Control é ativado através de um interruptor em Settings → App. Pode ligar-se a uma sessão em antigravity.google.com usando a mesma conta Google. A Antigravity CLI tem dois modos: /remote-control (ou a opção --remote-control) abre um túnel durante a sessão do terminal, enquanto agy remote-control start inicia um daemon em segundo plano sem um terminal aberto. No Linux, o daemon continua a funcionar depois de terminar sessão e inicia após um reinício; no Windows, isso requer instalação por um administrador; no macOS e numa instalação padrão do Windows, retoma na sessão seguinte. O computador tem de estar ligado e conectado à Internet. A funcionalidade pode estar indisponível devido às políticas da conta ou da organização, ou às condições do plano.
Se ainda não instalou o Antigravity, comece por uma visão geral de o que é o Google Antigravity e como o instalar. Este guia destina-se a quem já tem um agente a executar uma tarefa demorada (refatorização, execução de testes, migração de dependências) e precisa de se afastar da secretária sem perder o controlo da sessão.
O que é o Remote Control e para que serve
O Remote Control é uma funcionalidade do Google Antigravity que permite ligar-se em segurança a sessões de computador e CLI nas suas máquinas e controlá-las a partir de qualquer navegador Web. De acordo com a descrição oficial, as tarefas de grande dimensão — por exemplo, a refatorização completa de um subsistema, uma execução de testes demorada ou uma migração complexa de dependências — podem demorar muito tempo. O Remote Control permite gerir uma sessão quando está longe do computador, mantendo todo o seu ambiente de desenvolvimento local.
A funcionalidade está disponível tanto na aplicação para computador 2.0 como na CLI — a versão de terminal do Antigravity (agy) —, mas a ativação e o comportamento são diferentes em cada uma.
Ativar o Remote Control no Antigravity para computador 2.0
Pode ativar o Remote Control nas definições da aplicação:
- Abra o painel Settings com
Cmd + ,(ouCtrl + ,no Linux e no Windows), ou clique no botão Settings na parte inferior do painel esquerdo. - Aceda à secção App.
- Mude Enable Remote Control para On.
- (Opcional) Defina um Nickname, como
workstation-primaryouserver-machine, para reconhecer facilmente esta máquina na lista de dispositivos ligados.
Ligar-se a partir de um telemóvel ou de outro navegador
Para abrir uma sessão remota:
- Abra um navegador em qualquer dispositivo e aceda ao painel do Antigravity Remote Control. Num telemóvel, também pode instalar a aplicação Web no ecrã principal para receber notificações push quando o agente terminar uma tarefa ou lhe pedir uma resposta.
- Inicie sessão com a mesma conta Google que utiliza no computador.
- Selecione a máquina pretendida no seletor de dispositivos.
- Depois de se ligar, pode ver as conversas ativas; pode iniciar novas tarefas para o agente e consultar planos de implementação e artefactos.
Se a máquina não aparecer na interface Web, as instruções oficiais recomendam verificar três aspetos: se o interruptor Enable Remote Control está ativado no computador onde o Antigravity está a ser executado; se esse computador tem ligação à Internet e não entrou em suspensão; e se a aplicação para computador e o navegador utilizam a mesma conta Google.
Se a ligação de rede for temporariamente interrompida no dispositivo que está a utilizar para se ligar, a interface Web tentará restabelecer a ligação automaticamente. As tarefas em segundo plano do agente e os comandos iniciados no terminal continuam a ser executados no computador com o Antigravity sem interrupções, desde que permaneça ligado à Internet.
Dois modos de Remote Control na Antigravity CLI
A CLI tem dois modos: um modo interativo associado a um processo de terminal específico e um daemon sem interface gráfica em segundo plano, que funciona sem um terminal aberto.
Modo interativo: /remote-control
Pode ativar o Remote Control na sessão interativa agy atual sem reiniciar a CLI. Execute este comando na linha de entrada:
/remote-control
De acordo com a descrição oficial, a CLI abre uma ligação — um túnel inverso — para a sessão atual e apresenta o nome do anfitrião, juntamente com uma ligação para a conversa ativa noutro dispositivo:
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.
Abra esta ligação num navegador num portátil, tablet ou telemóvel, inicie sessão com a mesma conta Google que utiliza na CLI e continue a trabalhar na sessão através da interface Web do Antigravity.
Para desativar o túnel sem terminar a sessão local do terminal:
/remote-control off
Pode iniciar a CLI com o Remote Control já ativado usando uma opção no arranque:
agy --remote-control
O modo interativo está associado ao processo agy: quando sai da CLI (/exit, Ctrl+C, Ctrl+D) ou fecha a janela do terminal, o túnel do Remote Control termina automaticamente e a entrada da sessão desaparece do painel. Cada processo interativo da CLI tem o seu próprio ID de sessão e nome de anfitrião, pelo que pode executar agy --remote-control em simultâneo em vários separadores de terminal ou diretórios de trabalho.
Quando se liga a uma sessão interativa da CLI a partir de um navegador, ambos os lados sincronizam em tempo real. Os pedidos do dispositivo remoto seguem diretamente para o terminal local, enquanto o raciocínio do agente, as chamadas a ferramentas e as alterações ao código são visíveis na interface remota. Se o agente fizer uma pausa para pedir confirmação (y/n) ou colocar uma pergunta de seguimento, pode responder a partir do telemóvel ou do terminal local. As definições são a exceção: não as pode alterar na interface Web remota, apenas na própria CLI.
Daemon sem interface gráfica: agy remote-control start
O segundo modo é um daemon persistente em segundo plano que é registado como um serviço do sistema operativo. Está disponível enquanto a máquina estiver ligada e conectada à Internet; o comportamento após terminar sessão e reiniciar depende da plataforma.
agy remote-control start
O daemon é registado como um serviço do sistema operativo (um serviço de utilizador systemd no Linux, um LaunchAgent no macOS ou uma Tarefa Agendada no Windows) e inicia imediatamente, sem uma janela de terminal aberta.
Use agy remote-control status para ver o nome da entrada. Em seguida, selecione esta máquina no painel do Antigravity Remote Control e continue a trabalhar através da interface Web do Antigravity.
Três comandos controlam o daemon:
agy remote-control start Registar e iniciar o daemon
agy remote-control status Mostrar o estado e o nome da instância do daemon
agy remote-control stop Parar e cancelar o registo do daemon
O daemon utiliza as credenciais com que iniciou sessão na CLI. Iniciar sessão na CLI é um processo separado de iniciar sessão no editor Antigravity para computador na mesma máquina; no navegador, utilize a mesma conta Google que na CLI.
Pode definir o nome da máquina do daemon sem interface gráfica com a opção --name no arranque:
agy remote-control start --name "my-workstation"
Se voltar a executar start --name com um novo valor, o nome da máquina será alterado.
Se não definir um nome, o daemon gera um nome fácil de memorizar (como my-machine-distant-plume) no primeiro arranque; agy remote-control status mostra o nome atual. Também pode mudar o nome no ficheiro de definições: abra ~/.gemini/config/config.json no Linux/macOS ou %USERPROFILE%\.gemini\config\config.json no Windows, altere o valor de cliRemoteControlHostname, guarde o ficheiro e execute novamente agy remote-control start para reiniciar o daemon. O novo nome aparecerá no painel depois de o serviço reiniciar; as alterações ao ficheiro não têm efeito enquanto o daemon estiver em execução.
O ficheiro contém dois campos semelhantes. cliRemoteControlHostname é o nome do daemon da CLI utilizado aqui. remoteControlHostname é um campo separado para o editor Antigravity para computador na mesma máquina; no Antigravity 2.0, pode alterá-lo em Settings → App.
Comportamento do daemon após terminar sessão e reiniciar
O comportamento depende do sistema operativo:
| Comportamento | Linux | macOS | Windows |
|---|---|---|---|
| Arranque | No arranque do sistema; não é necessário iniciar sessão | Ao iniciar sessão | No arranque do sistema (se instalado por um administrador); caso contrário, ao iniciar sessão |
| Continua a funcionar depois de terminar sessão | Sim | Não; retoma na sessão seguinte | Sim, se estiver configurado para iniciar no arranque |
| Recupera automaticamente após uma falha | Sim | Sim | Sim, até três tentativas de reinício; depois, no arranque seguinte ou quando agy remote-control start for executado novamente |
Detalhes específicos do Windows
O registo do daemon para arranque automático no arranque do sistema requer a execução com privilégios de administrador. Pode utilizar o PowerShell ou a linha de comandos normal. O comando start também funciona numa janela normal, mas, depois de terminar sessão ou reiniciar, o daemon só retoma no início da sessão seguinte, não no arranque do sistema. Os comandos status e stop funcionam numa janela normal, sem privilégios elevados.
Que modo escolher
| Critério | Interativo (/remote-control / agy --remote-control) | Daemon sem interface gráfica (agy remote-control start) |
|---|---|---|
| Âmbito | Uma sessão de terminal interativa | A máquina inteira (serviço do sistema operativo em segundo plano) |
| Ciclo de vida | Ativo enquanto o Remote Control estiver ativado e a sessão do terminal estiver em execução | Mantém-se após terminar sessão e reiniciar no Linux e no Windows quando instalado por um administrador; no macOS e numa instalação padrão do Windows, retoma na sessão seguinte |
| Nome da entrada | Novo em cada sessão (por exemplo, host-swift-falcon) | Um nome permanente para a máquina (--name ou cliRemoteControlHostname) |
| Utilização simultânea | Várias sessões de terminal em simultâneo numa máquina | Um serviço daemon por máquina |
| Ligação direta | A CLI apresenta uma ligação para a conversa ativa | Acesso através do seletor de dispositivos em antigravity.google.com |
| Ideal para | Afastar-se de uma tarefa ativa no terminal e continuar a partir de um telemóvel ou navegador | Acesso remoto persistente a uma estação de trabalho ou servidor enquanto a máquina estiver ligada e conectada à Internet, sujeito às condições do sistema operativo |
O modo interativo é suficiente para gerir uma tarefa atual a partir do telemóvel. Se precisar de acesso remoto sem um terminal aberto, utilize o daemon sem interface gráfica, sujeito às condições do seu sistema operativo.
O que fazer se tiver problemas de ligação
Problemas e soluções indicados na documentação oficial:
| O que vê | Porquê | O que fazer |
|---|---|---|
Remote control is not enabled for your account | A sua conta ou a política da organização não ativou a funcionalidade Remote Control | Contacte o administrador do espaço de trabalho ou verifique se o seu plano suporta o Remote Control |
| A entrada desaparece do painel (CLI) | /remote-control e agy --remote-control criam túneis que se desligam automaticamente quando sai da sessão interativa (/exit, Ctrl+C) ou executa /remote-control off | Se precisar que a máquina continue disponível sem um terminal aberto, instale o daemon sem interface gráfica com agy remote-control start |
| Aparecem várias entradas da CLI da mesma máquina no painel | Cada sessão interativa da CLI tem o seu próprio nome de anfitrião; isto é normal quando há vários terminais abertos | Não é necessária nenhuma ação; este comportamento é esperado |
| A máquina não aparece no painel (daemon) | Pode haver um problema ao iniciar sessão na CLI | Execute agy remote-control status; se indicar um problema de início de sessão, execute agy, inicie sessão novamente e, em seguida, execute mais uma vez agy remote-control start |
| A alteração do nome não teve efeito | O nome é lido quando o daemon inicia | Execute novamente agy remote-control start para reiniciar o daemon |
| No Windows, o daemon só inicia ao iniciar sessão, não no arranque | O comando start foi executado sem privilégios de administrador | Execute novamente agy remote-control start numa janela com privilégios elevados |
| A ligação continua a cair e a restabelecer-se | Um daemon antigo instalado através do script de instalação ainda pode estar registado e a competir com o novo pela ligação | Execute novamente agy remote-control start; o serviço antigo é removido automaticamente |
| Aparecem duas entradas semelhantes para uma máquina no painel | Uma entrada é o editor e a outra é o daemon da CLI; são intencionalmente distintas | Mude o nome da que precisa de distinguir |
| A máquina não aparece no painel Web (computador) | O interruptor pode estar desligado, pode não haver ligação à Internet, o computador pode estar em suspensão ou podem estar a ser utilizadas contas Google diferentes | Verifique o interruptor Enable Remote Control, a ligação à Internet do computador, se não está em suspensão e se a conta é a mesma nos dois lados |
Para diagnósticos mais detalhados, consulte os registos do daemon: no Linux, execute journalctl --user -u antigravity-cli-daemon -n 50; no macOS, consulte ~/Library/Logs/antigravity-cli-daemon.log; no Windows, consulte o ficheiro cli-*.log mais recente em %USERPROFILE%\.gemini\antigravity-cli\log.
O daemon sem interface gráfica permite o acesso sem um terminal aberto, incluindo quando está ausente, sujeito às condições de funcionamento do computador e do sistema operativo. Se já não precisar de acesso persistente, pare o daemon com agy remote-control stop.
Existe um artigo separado sobre o controlo remoto no Claude Code. Para controlar outro agente através do Telegram, consulte como configurar o Hermes Agent no Telegram.
O que fazer a seguir
Se trabalha na CLI e quer afastar-se da tarefa atual, comece pelo modo interativo. Deixe o terminal aberto: se o fechar, o túnel desliga-se e a entrada da sessão desaparece do painel. Para aceder à máquina sem um terminal aberto, utilize o daemon, sujeito às limitações do seu sistema operativo.
Fontes
Há mais materiais disponíveis no Ailoot.
Mais detalhes
Perguntas frequentes
Porque desaparece a sessão remota ao fechar o terminal?
Remote Control interativo pertence ao processo agy em execução; sair fecha o túnel. Para acesso sem terminal aberto, use o serviço headless e verifique as condições de arranque no sistema operativo.
O que verifico se a máquina não aparecer no dashboard?
Confirme que está acordada e online, Remote Control está ativo e o navegador usa a mesma conta Google que desktop ou CLI. Numa sessão do serviço, consulte agy remote-control status para problemas de autenticação ou serviço.