Google Antigravity Remote Control: zo bedien je de agent vanaf je telefoon

Heb je Antigravity nog niet geïnstalleerd? Begin dan met een overzicht van wat Google Antigravity is en hoe je het installeert. Deze handleiding is bedoeld voor situaties waarin een agent al een lange taak uitvoert (refactoring, tests uitvoeren, afhankelijkheden migreren) en je je werkplek wilt verlaten terwijl je de sessie onder controle houdt.

Wat Remote Control is en waarom je het nodig hebt#

Remote Control is een functie van Google Antigravity waarmee je veilig verbinding kunt maken met desktop- en CLI-sessies op je machines en deze vanuit elke webbrowser kunt bedienen. Volgens de officiële beschrijving kunnen grote taken — bijvoorbeeld een volledige refactoring van een subsysteem, een lange testrun of een complexe migratie van afhankelijkheden — veel tijd kosten. Met Remote Control kun je een sessie beheren terwijl je niet bij je computer bent, terwijl je volledige ontwikkelomgeving lokaal blijft.

De functie werkt zowel in desktopapp 2.0 als in de CLI, de terminalversie van Antigravity (agy), maar wordt in beide op een andere manier ingeschakeld en werkt anders.

Remote Control inschakelen in Antigravity 2.0 voor desktop#

Je kunt Remote Control inschakelen in de app-instellingen:

1. Open het paneel Instellingen met Cmd + , (of Ctrl + , op Linux en Windows), of klik onderaan het linkerpaneel op de knop Instellingen.
2. Ga naar de sectie App.
3. Zet Enable Remote Control op On.
4. (Optioneel) Stel een Nickname in, zoals workstation-primary of server-machine, zodat je deze machine gemakkelijk herkent in de lijst met verbonden apparaten.

Verbinding maken vanaf een telefoon of een andere browser

Zo open je een externe sessie:

1. Open een browser op een apparaat en ga naar het Antigravity Remote Control-dashboard. Op een telefoon kun je de webapp ook op je startscherm installeren, zodat je pushmeldingen ontvangt wanneer de agent een taak afrondt of om je reactie vraagt.
2. Meld je aan met hetzelfde Google-account dat je op de desktop gebruikt.
3. Selecteer de gewenste machine in de apparaatkiezer.
4. Zodra je verbonden bent, kun je actieve gesprekken bekijken; je kunt nieuwe taken voor de agent starten en implementatieplannen en artefacten bekijken.

Als de machine niet in de webinterface verschijnt, adviseren de officiële instructies om drie dingen te controleren: of de schakelaar Enable Remote Control aanstaat op de computer waarop Antigravity draait; of die computer een internetverbinding heeft en niet in de slaapstand is gegaan; en of de desktopapp en browser hetzelfde Google-account gebruiken.

Als de netwerkverbinding op het apparaat dat je gebruikt om verbinding te maken tijdelijk wegvalt, probeert de webinterface automatisch opnieuw verbinding te maken. De achtergrondtaken van de agent en opdrachten die vanuit de terminal zijn gestart, blijven zonder onderbreking draaien op de computer met Antigravity, zolang deze met internet verbonden blijft.

Twee Remote Control-modi in Antigravity CLI#

De CLI heeft twee modi: een interactieve modus die aan een specifiek terminalproces is gekoppeld, en een headless achtergronddaemon die zonder geopende terminal draait.

Interactieve modus: /remote-control

Je kunt Remote Control inschakelen in de huidige interactieve agy-sessie zonder de CLI opnieuw te starten. Voer dit in op de invoerregel:

/remote-control

Volgens de officiële beschrijving opent de CLI een verbinding — een omgekeerde tunnel — voor de huidige sessie en toont de hostnaam en een link naar het actieve gesprek voor een ander apparaat:

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.

Open deze link in een browser op een laptop, tablet of telefoon, meld je aan met hetzelfde Google-account dat je in de CLI gebruikt en ga verder met de sessie via de Antigravity-webinterface.

Zo schakel je de tunnel uit zonder de lokale terminalsessie te beëindigen:

/remote-control off

Je kunt de CLI starten met Remote Control al ingeschakeld door bij het opstarten een vlag te gebruiken:

agy --remote-control

De interactieve modus is gekoppeld aan het agy-proces: wanneer je de CLI afsluit (/exit, Ctrl+C, Ctrl+D) of het terminalvenster sluit, wordt de Remote Control-tunnel automatisch beëindigd en verdwijnt de sessie uit het dashboard. Elk interactief CLI-proces heeft een eigen sessie-ID en hostnaam, zodat je agy --remote-control tegelijk in meerdere terminaltabbladen of werkmappen kunt uitvoeren.

Wanneer je vanuit een browser verbinding maakt met een interactieve CLI-sessie, worden beide kanten in realtime gesynchroniseerd. Verzoeken vanaf het externe apparaat gaan rechtstreeks naar de lokale terminal, terwijl de redenering van de agent, toolaanroepen en codewijzigingen in de externe interface zichtbaar zijn. Als de agent pauzeert om bevestiging te vragen (y/n) of een vervolgvraag stelt, kun je antwoorden vanaf je telefoon of de lokale terminal. Instellingen vormen hierop een uitzondering: je kunt ze niet wijzigen vanuit de externe webinterface, alleen vanuit de CLI zelf.

Headless daemon: agy remote-control start

De tweede modus is een blijvende achtergronddaemon die zich registreert als OS-service. Deze is beschikbaar zolang de machine aan staat en met internet verbonden is; het gedrag na uitloggen en opnieuw opstarten hangt af van het platform.

agy remote-control start

De daemon registreert zich als OS-service (een systemd-gebruikersservice op Linux, een LaunchAgent op macOS of een Scheduled Task op Windows) en start onmiddellijk, zonder geopend terminalvenster.

Gebruik agy remote-control status om de naam van de vermelding te zien. Selecteer vervolgens deze machine op het Antigravity Remote Control-dashboard en ga verder via de Antigravity-webinterface.

Drie opdrachten bedienen de daemon:

agy remote-control start     Register and start the daemon
agy remote-control status    Show the daemon's status and instance name
agy remote-control stop      Stop the daemon and unregister it

De daemon gebruikt de inloggegevens waarmee je je bij de CLI hebt aangemeld. Aanmelden bij de CLI staat los van aanmelden bij de Antigravity-desktopeditor op dezelfde machine; gebruik in de browser hetzelfde Google-account als in de CLI.

Je kunt bij het starten de machinenaam van de headless daemon instellen met de vlag --name:

agy remote-control start --name "my-workstation"

Als je start --name opnieuw uitvoert met een nieuwe waarde, wordt de machinenaam gewijzigd.

Als je geen naam instelt, genereert de daemon bij de eerste start een makkelijk te onthouden naam (zoals my-machine-distant-plume); agy remote-control status toont de huidige naam. Je kunt de naam ook wijzigen in het instellingenbestand: open ~/.gemini/config/config.json op Linux/macOS of %USERPROFILE%\.gemini\config\config.json op Windows, wijzig de waarde van cliRemoteControlHostname, sla het bestand op en voer agy remote-control start opnieuw uit om de daemon opnieuw te starten. De nieuwe naam verschijnt na het herstarten van de service op het dashboard; wijzigingen aan het bestand worden niet toegepast zolang de daemon draait.

Er staan twee vergelijkbare velden in het bestand. cliRemoteControlHostname is de naam van de CLI-daemon die hier wordt besproken. remoteControlHostname is een apart veld voor de Antigravity-desktopeditor op dezelfde machine; in Antigravity 2.0 kun je dit wijzigen onder Instellingen → App.

Gedrag van de daemon na uitloggen en opnieuw opstarten

Het gedrag hangt af van het OS:

Specifieke informatie voor Windows

Voor het registreren van de daemon voor automatisch starten bij het opstarten van het systeem moet je als beheerder werken. Je kunt hiervoor PowerShell of de gewone opdrachtprompt gebruiken. De opdracht start werkt ook vanuit een gewoon venster, maar na uitloggen of opnieuw opstarten wordt de daemon pas bij de volgende aanmelding hervat, niet bij het opstarten. De opdrachten status en stop werken vanuit een gewoon venster zonder verhoogde bevoegdheden.

Welke modus moet je kiezen?

De interactieve modus is voldoende om een huidige taak vanaf je telefoon te beheren. Heb je externe toegang nodig zonder geopende terminal, gebruik dan de headless daemon, afhankelijk van de voorwaarden van je OS.

Wat je kunt doen bij verbindingsproblemen#

Problemen en oplossingen uit de officiële documentatie:

Controleer voor uitgebreidere diagnose de daemonlogs: voer op Linux journalctl --user -u antigravity-cli-daemon -n 50 uit; controleer op macOS ~/Library/Logs/antigravity-cli-daemon.log; en controleer op Windows het nieuwste cli-*.log-bestand in %USERPROFILE%\.gemini\antigravity-cli\log.

De headless daemon biedt toegang zonder geopende terminal, ook wanneer je niet in de buurt bent, afhankelijk van de bedrijfsomstandigheden van de computer en het OS. Heb je geen blijvende toegang meer nodig, stop dan de daemon met agy remote-control stop.

Er is een apart artikel over remote control in Claude Code. Zie Hermes Agent instellen in Telegram als je een andere agent via Telegram wilt bedienen.

Wat nu?#

Werk je in de CLI en wil je even weggaan bij de huidige taak, begin dan met de interactieve modus. Laat de terminal open: als je deze sluit, wordt de tunnel verbroken en verdwijnt de sessie uit het dashboard. Gebruik de daemon voor toegang tot de machine zonder geopende terminal, afhankelijk van de beperkingen van je OS.

Meer materiaal vind je op Ailoot.