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

> Zo schakel je Remote Control in Google Antigravity in op desktop en in de CLI: de schakelaar, de agy remote-control daemon en wat je kunt doen bij verbindingsproblemen.

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


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

[Ailoot-documentatie](https://ailoot.ai/docs/) — referentiemateriaal over het gebruik van de service.

</div>

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hoogtepunten van de sectie">

Hoogtepunten

In Antigravity 2.0 voor desktop schakel je Remote Control in met een schakelaar onder Instellingen → App. Je kunt verbinding maken met een sessie op antigravity.google.com via hetzelfde Google-account. Antigravity CLI heeft twee modi: `/remote-control` (of de vlag `--remote-control`) opent een tunnel zolang de terminalsessie duurt, terwijl `agy remote-control start` een achtergronddaemon start zonder geopende terminal. Op Linux blijft de daemon draaien nadat je uitlogt en start deze na een herstart; op Windows is hiervoor installatie door een beheerder vereist; op macOS en bij een standaardinstallatie van Windows wordt de daemon bij de volgende aanmelding hervat. De computer moet aan staan en verbonden zijn met internet. De functie is mogelijk niet beschikbaar vanwege account- of organisatiebeleid, of vanwege abonnementsvoorwaarden.

</div>

Heb je Antigravity nog niet geïnstalleerd? Begin dan met een overzicht van [wat Google Antigravity is en hoe je het installeert](https://ailoot.ai/blog/nl/google-antigravity/). 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](https://antigravity.google.com). 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.

<figure>
Diagram: de schakelaar voor Remote Control op een laptop draagt de bediening over aan een telefoon wanneer je met hetzelfde account bent aangemeld
<figcaption>Zo werkt Remote Control op desktop: zet de schakelaar op de computer aan en meld je vervolgens op de telefoon aan met hetzelfde Google-account.</figcaption>
</figure>



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

| Gedrag | Linux | macOS | Windows |
|----|----|----|----|
| Opstarten | Bij het opstarten; aanmelden is niet vereist | Bij aanmelden | Bij het opstarten (als een beheerder de daemon heeft geïnstalleerd); anders bij aanmelden |
| Blijft draaien na uitloggen | Ja | Nee; wordt bij de volgende aanmelding hervat | Ja, als starten bij het opstarten is geconfigureerd |
| Herstelt automatisch na een storing | Ja | Ja | Ja, tot drie herstartpogingen; daarna bij de volgende keer opstarten of wanneer `agy remote-control start` opnieuw wordt uitgevoerd |

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

| Criterium | Interactief (`/remote-control` / `agy --remote-control`) | Headless daemon (`agy remote-control start`) |
|----|----|----|
| Bereik | Eén interactieve terminalsessie | De hele machine (achtergrondservice van het OS) |
| Levenscyclus | Actief zolang Remote Control is ingeschakeld en de terminalsessie draait | Blijft actief na uitloggen en opnieuw opstarten op Linux en op Windows wanneer een beheerder de daemon heeft geïnstalleerd; op macOS en bij een standaardinstallatie van Windows wordt de daemon bij de volgende aanmelding hervat |
| Naam van de vermelding | Nieuw voor elke sessie (bijvoorbeeld `host-swift-falcon`) | Eén permanente machinenaam (`--name` of `cliRemoteControlHostname`) |
| Gelijktijdigheid | Meerdere terminalsessies tegelijk op één machine | Eén daemonservice per machine |
| Directe link | De CLI toont een link naar het actieve gesprek | Toegang via de apparaatkiezer op antigravity.google.com |
| Geschikt voor | Even weggaan bij een actieve terminaltaak en verdergaan vanaf een telefoon of browser | Blijvende externe toegang tot een werkstation of server zolang de machine aan staat en met internet verbonden is, afhankelijk van de OS-voorwaarden |

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.

<figure>
Diagram: de sessietunnel verdwijnt wanneer de terminal wordt gesloten; de achtergronddaemon draait zonder geopende terminal
<figcaption>Verschil tussen CLI-modi: de interactieve tunnel werkt alleen zolang de terminal open is; de headless daemon draait zonder geopende terminal (afhankelijk van de OS-voorwaarden in de bovenstaande tabel).</figcaption>
</figure>

## Wat je kunt doen bij verbindingsproblemen

Problemen en oplossingen uit de officiële documentatie:

| Wat je ziet | Waarom | Wat je kunt doen |
|----|----|----|
| `Remote control is not enabled for your account` | Remote Control is niet ingeschakeld voor je account of volgens het organisatiebeleid | Neem contact op met de beheerder van je werkruimte of controleer of je abonnement Remote Control ondersteunt |
| De vermelding verdwijnt uit het dashboard (CLI) | `/remote-control` en `agy --remote-control` maken tunnels die automatisch worden verbroken wanneer je de interactieve sessie afsluit (`/exit`, `Ctrl+C`) of `/remote-control off` uitvoert | Als de machine beschikbaar moet blijven zonder geopende terminal, installeer je de headless daemon met `agy remote-control start` |
| Er verschijnen meerdere CLI-vermeldingen van dezelfde machine op het dashboard | Elke interactieve CLI-sessie heeft een eigen hostnaam; dit is normaal als er meerdere terminals open zijn | Er is geen actie nodig; dit is verwacht gedrag |
| De machine verschijnt niet op het dashboard (daemon) | Er is mogelijk een probleem met aanmelden bij de CLI | Voer `agy remote-control status` uit; als deze opdracht een aanmeldprobleem meldt, voer je `agy` uit, meld je opnieuw aan en voer je daarna `agy remote-control start` nogmaals uit |
| De nieuwe naam is niet toegepast | De naam wordt gelezen wanneer de daemon start | Voer `agy remote-control start` opnieuw uit om de daemon opnieuw te starten |
| Op Windows start de daemon alleen bij aanmelden, niet bij het opstarten | De opdracht `start` is uitgevoerd zonder beheerdersrechten | Voer `agy remote-control start` opnieuw uit vanuit een venster met verhoogde bevoegdheden |
| De verbinding valt steeds weg en wordt opnieuw gemaakt | Mogelijk is er nog een oude daemon geregistreerd die via het installatiescript is geïnstalleerd en met de nieuwe daemon om de verbinding concurreert | Voer `agy remote-control start` opnieuw uit; de oude service wordt automatisch verwijderd |
| Er verschijnen twee vergelijkbare vermeldingen voor één machine op het dashboard | De ene vermelding is de editor, de andere de CLI-daemon; ze zijn bewust gescheiden | Wijzig de naam van de vermelding die je wilt onderscheiden |
| De machine verschijnt niet op het webdashboard (desktop) | De schakelaar staat mogelijk uit, er is mogelijk geen internetverbinding, de computer staat misschien in de slaapstand of er worden verschillende Google-accounts gebruikt | Controleer of de schakelaar **Enable Remote Control** aanstaat, of de computer met internet is verbonden en niet in de slaapstand staat, en of aan beide kanten hetzelfde account wordt gebruikt |

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](https://ailoot.ai/blog/nl/claude-code-remote-control-phone/). Zie [Hermes Agent instellen in Telegram](https://ailoot.ai/blog/nl/hermes-agent-telegram-setup/) 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.

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

### Bronnen

- [Antigravity Remote Control: officiële documentatie](https://antigravity.google/docs/remote-control.md)
- [Antigravity Features: overzicht van functies in 2.0](https://antigravity.google/docs/features.md)
- [Antigravity Getting Started: CLI-installatie](https://antigravity.google/docs/getting-started.md)

</div>



Meer materiaal vind je op [Ailoot](https://ailoot.ai/).

## Vragen en antwoorden

### Waarom verdwijnt de externe sessie wanneer ik de terminal sluit?

Interactieve Remote Control hoort bij het draaiende agy-proces; bij afsluiten daarvan sluit ook de tunnel. Gebruik voor toegang zonder open terminal de headless-daemon en controleer de opstartvoorwaarden van het besturingssysteem.

### Wat controleer ik als mijn machine in het dashboard ontbreekt?

Controleer of de machine wakker en online is, Remote Control is ingeschakeld en de browser hetzelfde Google-account gebruikt als desktop of CLI. Bekijk voor een daemonsessie agy remote-control status op aanmeld- of dienstproblemen.


## Ailoot · Het bedrijf en zijn projectenportefeuille

Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.
