# Google Antigravity Remote Control: como controlar o agente a partir do telemóvel

> Como 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.

Source: https://ailoot.ai/blog/pt-pt/antigravity-remote-control-phone/
Canonical: https://ailoot.ai/blog/pt-pt/antigravity-remote-control-phone/
Language: pt-PT
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-009
Revision: sha256-0ef1ae1c229de2d6b8e3ebdcb4312b9a1ddfa9f2ec42c6ea80190b2bac8317f3


<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Ailoot documentation">

[Documentação do Ailoot](https://ailoot.ai/docs/) — materiais de referência sobre a utilização do serviço.

</div>

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

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.

</div>

Se ainda não instalou o Antigravity, comece por uma visão geral de [o que é o Google Antigravity e como o instalar](https://ailoot.ai/blog/pt-pt/google-antigravity/). 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:

1. Abra o painel **Settings** com `Cmd + ,` (ou `Ctrl + ,` no Linux e no Windows), ou clique no botão **Settings** na parte inferior do painel esquerdo.
2. Aceda à secção **App**.
3. Mude **Enable Remote Control** para **On**.
4. *(Opcional)* Defina um **Nickname**, como `workstation-primary` ou `server-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:

1. Abra um navegador em qualquer dispositivo e aceda ao [painel do Antigravity Remote Control](https://antigravity.google.com). 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.
2. Inicie sessão com a mesma conta Google que utiliza no computador.
3. Selecione a máquina pretendida no seletor de dispositivos.
4. 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.

<figure>
Diagrama: o interruptor Remote Control num portátil transfere o controlo para um telemóvel quando a sessão é iniciada com a mesma conta
<figcaption>Como funciona o Remote Control no computador: ative o interruptor no computador e, em seguida, inicie sessão no telemóvel com a mesma conta Google.</figcaption>
</figure>



## 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](https://antigravity.google.com) 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.

<figure>
Diagrama: o túnel da sessão desaparece quando o terminal é fechado; o daemon em segundo plano é executado sem um terminal aberto
<figcaption>Diferença entre os modos CLI: o túnel interativo funciona apenas enquanto o terminal está aberto; o daemon sem interface gráfica funciona sem um terminal aberto (sujeito às condições do sistema operativo indicadas na tabela acima).</figcaption>
</figure>

## 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](https://ailoot.ai/blog/pt-pt/claude-code-remote-control-phone/). Para controlar outro agente através do Telegram, consulte [como configurar o Hermes Agent no Telegram](https://ailoot.ai/blog/pt-pt/hermes-agent-telegram-setup/).

## 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.

<div class="section" role="doc-bibliography" aria-label="Sources">

### Fontes

- [Antigravity Remote Control: documentação oficial](https://antigravity.google/docs/remote-control.md)
- [Antigravity Features: visão geral das funcionalidades da versão 2.0](https://antigravity.google/docs/features.md)
- [Antigravity Getting Started: instalação da CLI](https://antigravity.google/docs/getting-started.md)

</div>



Há mais materiais disponíveis no [Ailoot](https://ailoot.ai/).

## 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.


## Ailoot · A empresa e a sua carteira de projetos

A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.