Antigravity Remote Control: Agenten vom Smartphone steuern

Wenn du Antigravity noch nicht installiert hast, beginne mit einem Überblick darüber, was Google Antigravity ist und wie du es installierst. Diese Anleitung richtet sich an Situationen, in denen ein Agent bereits eine längere Aufgabe bearbeitet (Refactoring, Tests ausführen, Abhängigkeiten migrieren) und du deinen Schreibtisch verlassen musst, während du die Sitzung weiterhin kontrollierst.

Was ist Remote Control in Google Antigravity?#

Remote Control ist eine Google-Antigravity-Funktion, mit der du sicher eine Verbindung zu Desktop- und CLI-Sitzungen auf deinen Rechnern herstellen und diese über jeden Webbrowser steuern kannst. Laut der offiziellen Beschreibung können große Aufgaben – zum Beispiel ein vollständiges Refactoring eines Subsystems, ein langer Testlauf oder eine komplexe Migration von Abhängigkeiten – viel Zeit in Anspruch nehmen. Mit Remote Control kannst du eine Sitzung verwalten, während du nicht an deinem Computer bist, und deine gesamte Entwicklungsumgebung bleibt lokal.

Die Funktion ist sowohl in der Desktop-App 2.0 als auch in der CLI verfügbar, der Terminalversion von Antigravity (agy), wird aber in beiden unterschiedlich aktiviert und verhält sich unterschiedlich.

Remote Control in Antigravity 2.0 für den Desktop aktivieren#

Du kannst Remote Control in den App-Einstellungen aktivieren:

1. Öffne das Bedienfeld Einstellungen mit Cmd + , (oder Ctrl + , unter Linux und Windows) oder klicke unten im linken Bereich auf die Schaltfläche Einstellungen.
2. Gehe zum Abschnitt App.
3. Stelle Enable Remote Control auf On.
4. (Optional) Lege einen Nickname fest, zum Beispiel workstation-primary oder server-machine, damit du diesen Rechner in der Liste der verbundenen Geräte leicht erkennst.

Von einem Smartphone oder einem anderen Browser aus verbinden

So öffnest du eine Remote-Sitzung:

1. Öffne auf einem beliebigen Gerät einen Browser und rufe das Antigravity Remote Control-Dashboard auf. Auf einem Smartphone kannst du die Web-App auch auf dem Startbildschirm installieren, um Push-Benachrichtigungen zu erhalten, wenn der Agent eine Aufgabe abgeschlossen hat oder eine Antwort von dir benötigt.
2. Melde dich mit demselben Google-Konto an, das du auf dem Desktop verwendest.
3. Wähle im Gerätewechsler den gewünschten Rechner aus.
4. Nach der Verbindung kannst du aktive Unterhaltungen sehen, neue Aufgaben für den Agenten starten und Implementierungspläne sowie Artefakte anzeigen.

Wenn der Rechner nicht in der Weboberfläche erscheint, empfehlen die offiziellen Anweisungen, drei Dinge zu überprüfen: ob der Schalter Enable Remote Control auf dem Computer, auf dem Antigravity läuft, eingeschaltet ist; ob dieser Computer eine Internetverbindung hat und nicht in den Ruhezustand gewechselt ist; und ob Desktop-App und Browser dasselbe Google-Konto verwenden.

Wenn die Netzwerkverbindung auf dem Gerät, das du zum Verbinden verwendest, vorübergehend unterbrochen wird, versucht die Weboberfläche automatisch, die Verbindung wiederherzustellen. Die Hintergrundaufgaben des Agenten und die im Terminal gestarteten Befehle laufen auf dem Computer mit Antigravity ununterbrochen weiter, solange er mit dem Internet verbunden bleibt.

Zwei Remote-Control-Modi in Antigravity CLI#

Die CLI hat zwei Modi: einen interaktiven Modus, der an einen bestimmten Terminalprozess gebunden ist, und einen Headless-Hintergrund-Daemon, der ohne geöffnetes Terminal läuft.

Interaktiver Modus: /remote-control

Du kannst Remote Control in der aktuellen interaktiven agy-Sitzung aktivieren, ohne die CLI neu zu starten. Führe dies in der Eingabezeile aus:

/remote-control

Laut der offiziellen Beschreibung öffnet die CLI für die aktuelle Sitzung eine Verbindung – einen Reverse-Tunnel – und gibt den Hostnamen sowie einen Link zur aktiven Unterhaltung aus, den du auf einem anderen Gerät verwenden kannst:

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.

Öffne diesen Link in einem Browser auf einem Laptop, Tablet oder Smartphone, melde dich mit demselben Google-Konto an, das du in der CLI verwendest, und setze die Arbeit in der Sitzung über die Antigravity-Weboberfläche fort.

So deaktivierst du den Tunnel, ohne die lokale Terminalsitzung zu beenden:

/remote-control off

Du kannst die CLI mit bereits aktiviertem Remote Control starten, indem du beim Start ein Flag verwendest:

agy --remote-control

Der interaktive Modus ist an den agy-Prozess gebunden: Wenn du die CLI beendest (/exit, Ctrl+C, Ctrl+D) oder das Terminalfenster schließt, wird der Remote-Control-Tunnel automatisch beendet und der Sitzungseintrag verschwindet aus dem Dashboard. Jeder interaktive CLI-Prozess hat eine eigene Sitzungs-ID und einen eigenen Hostnamen. Daher kannst du agy --remote-control gleichzeitig in mehreren Terminal-Tabs oder Arbeitsverzeichnissen ausführen.

Wenn du dich über einen Browser mit einer interaktiven CLI-Sitzung verbindest, werden beide Seiten in Echtzeit synchronisiert. Anfragen vom Remote-Gerät gehen direkt an das lokale Terminal, während die Schlussfolgerungen des Agenten, Tool-Aufrufe und Codeänderungen in der Remote-Oberfläche sichtbar sind. Wenn der Agent anhält, um eine Bestätigung (y/n) einzuholen oder eine Rückfrage zu stellen, kannst du von deinem Smartphone oder dem lokalen Terminal aus antworten. Einstellungen sind die Ausnahme: Du kannst sie nicht über die Remote-Weboberfläche ändern, sondern nur direkt in der CLI.

Headless-Daemon: agy remote-control start

Der zweite Modus ist ein dauerhaft laufender Hintergrund-Daemon, der als OS-Dienst registriert wird. Er ist verfügbar, solange der Rechner eingeschaltet und mit dem Internet verbunden ist; das Verhalten nach dem Abmelden und einem Neustart hängt von der Plattform ab.

agy remote-control start

Der Daemon wird als OS-Dienst registriert (als systemd-Benutzerdienst unter Linux, LaunchAgent unter macOS oder Scheduled Task unter Windows) und startet sofort, ohne geöffnetes Terminalfenster.

Verwende agy remote-control status, um den Namen des Eintrags anzuzeigen. Wähle anschließend diesen Rechner im Antigravity Remote Control-Dashboard aus und setze die Arbeit über die Antigravity-Weboberfläche fort.

Drei Befehle steuern den 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

Der Daemon verwendet die Anmeldedaten, mit denen du dich bei der CLI angemeldet hast. Die Anmeldung bei der CLI ist getrennt von der Anmeldung beim Antigravity-Desktopeditor auf demselben Rechner; verwende im Browser dasselbe Google-Konto wie in der CLI.

Du kannst den Rechnernamen des Headless-Daemons beim Start mit dem Flag --name festlegen:

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

Wenn du start --name erneut mit einem neuen Wert ausführst, wird der Rechner umbenannt.

Wenn du keinen Namen festlegst, erzeugt der Daemon bei seinem ersten Start einen einprägsamen Namen (zum Beispiel my-machine-distant-plume); agy remote-control status zeigt den aktuellen Namen an. Du kannst ihn auch in der Einstellungsdatei ändern: Öffne unter Linux/macOS ~/.gemini/config/config.json oder unter Windows %USERPROFILE%\.gemini\config\config.json, ändere den Wert von cliRemoteControlHostname, speichere die Datei und führe agy remote-control start erneut aus, um den Daemon neu zu starten. Der neue Name erscheint nach dem Neustart des Dienstes im Dashboard; Änderungen an der Datei werden nicht übernommen, solange der Daemon läuft.

In der Datei gibt es zwei ähnliche Felder. cliRemoteControlHostname ist der hier beschriebene Name des CLI-Daemons. remoteControlHostname ist ein separates Feld für den Antigravity-Desktopeditor auf demselben Rechner; in Antigravity 2.0 kannst du es unter Einstellungen → App ändern.

Verhalten des Daemons nach dem Abmelden und einem Neustart

Das Verhalten hängt vom OS ab:

Besonderheiten unter Windows

Um den Daemon für den automatischen Start beim Systemstart zu registrieren, musst du als Administrator arbeiten. Du kannst dafür PowerShell oder die normale Eingabeaufforderung verwenden. Der Befehl start funktioniert auch in einem normalen Fenster, aber nach dem Abmelden oder einem Neustart wird der Daemon erst bei der nächsten Anmeldung und nicht beim Systemstart fortgesetzt. Die Befehle status und stop funktionieren in einem normalen Fenster ohne erhöhte Rechte.

Welchen Modus solltest du wählen?

Der interaktive Modus reicht aus, um eine aktuelle Aufgabe von deinem Smartphone aus zu verwalten. Wenn du Fernzugriff ohne geöffnetes Terminal brauchst, verwende den Headless-Daemon, abhängig von den Bedingungen deines OS.

Was du bei Verbindungsproblemen tun kannst#

Probleme und Lösungen aus der offiziellen Dokumentation:

Für eine ausführlichere Diagnose kannst du die Daemon-Protokolle prüfen: Führe unter Linux journalctl --user -u antigravity-cli-daemon -n 50 aus; prüfe unter macOS ~/Library/Logs/antigravity-cli-daemon.log; und prüfe unter Windows die neueste cli-*.log-Datei in %USERPROFILE%\.gemini\antigravity-cli\log.

Der Headless-Daemon ermöglicht den Zugriff ohne geöffnetes Terminal, auch wenn du nicht am Rechner bist, abhängig von den Betriebsbedingungen des Computers und des OS. Wenn du keinen dauerhaften Zugriff mehr brauchst, stoppe den Daemon mit agy remote-control stop.

Es gibt einen separaten Artikel über Remote Control in Claude Code. Wenn du einen anderen Agenten über Telegram steuern möchtest, findest du weitere Informationen unter Hermes Agent in Telegram einrichten.

Wie geht es weiter?#

Wenn du in der CLI arbeitest und dich von der aktuellen Aufgabe entfernen möchtest, beginne mit dem interaktiven Modus. Lass das Terminal geöffnet: Wenn du es schließt, wird der Tunnel getrennt und der Sitzungseintrag verschwindet aus dem Dashboard. Für den Zugriff auf den Rechner ohne geöffnetes Terminal verwendest du den Daemon, abhängig von den Einschränkungen deines OS.

Weitere Materialien findest du auf Ailoot.