Blog

Google Antigravity Remote Control: jak sterować agentem z telefonu

Markdown

Jak włączyć Remote Control w Google Antigravity na komputerze i w CLI: przełącznik, demon agy remote-control oraz sposoby postępowania w razie problemów z połączeniem.

Przeczytaj cały artykuł

Dokumentacja Ailoot — materiały referencyjne na temat korzystania z usługi.

Najważniejsze informacje

W komputerowej wersji Antigravity 2.0 funkcję Remote Control włącza się przełącznikiem w Settings → App. Możesz połączyć się z sesją na antigravity.google.com, używając tego samego konta Google. Antigravity CLI ma dwa tryby: /remote-control (lub flaga --remote-control) otwiera tunel na czas sesji terminala, natomiast agy remote-control start uruchamia demona działającego w tle bez otwartego terminala. W systemie Linux demon działa nadal po wylogowaniu i uruchamia się po ponownym rozruchu; w systemie Windows wymaga to instalacji przez administratora; w systemie macOS i przy standardowej instalacji systemu Windows działanie zostaje wznowione przy następnym logowaniu. Komputer musi być włączony i połączony z internetem. Funkcja może być niedostępna z powodu zasad dotyczących konta lub organizacji albo warunków planu.

Jeśli nie masz jeszcze zainstalowanego Antigravity, zacznij od przeglądu czym jest Google Antigravity i jak je zainstalować. Ten poradnik jest przeznaczony dla sytuacji, w której agent wykonuje już długie zadanie (refaktoryzację, uruchamianie testów, migrację zależności), a Ty musisz odejść od biurka, zachowując kontrolę nad sesją.

Czym jest Remote Control i dlaczego może Ci się przydać

Remote Control to funkcja Google Antigravity, która pozwala bezpiecznie łączyć się z sesjami komputerowymi i CLI na Twoich maszynach oraz sterować nimi z dowolnej przeglądarki internetowej. Zgodnie z oficjalnym opisem duże zadania — na przykład refaktoryzacja całego podsystemu, długie uruchomienie testów czy złożona migracja zależności — mogą zająć dużo czasu. Remote Control pozwala zarządzać sesją, gdy jesteś z dala od komputera, a całe środowisko programistyczne pozostaje lokalne.

Funkcja działa zarówno w aplikacji komputerowej w wersji 2.0, jak i w CLI — terminalowej wersji Antigravity (agy) — ale sposób jej włączania i działania różni się w obu przypadkach.

Włączanie Remote Control w komputerowej wersji Antigravity 2.0

Możesz włączyć Remote Control w ustawieniach aplikacji:

  1. Otwórz panel Settings, naciskając Cmd + , (lub Ctrl + , w systemach Linux i Windows), albo kliknij przycisk Settings u dołu lewego panelu.
  2. Przejdź do sekcji App.
  3. Przestaw Enable Remote Control na On.
  4. (Opcjonalnie) Ustaw Nickname, na przykład workstation-primary lub server-machine, aby łatwo rozpoznawać tę maszynę na liście połączonych urządzeń.

Łączenie z telefonu lub innej przeglądarki

Aby otworzyć sesję zdalną:

  1. Otwórz przeglądarkę na dowolnym urządzeniu i przejdź do Antigravity Remote Control Dashboard. Na telefonie możesz też zainstalować aplikację internetową na ekranie głównym, aby otrzymywać powiadomienia push, gdy agent zakończy zadanie lub poprosi o odpowiedź.
  2. Zaloguj się na to samo konto Google, którego używasz na komputerze.
  3. W selektorze urządzeń wybierz odpowiednią maszynę.
  4. Po połączeniu możesz przeglądać aktywne rozmowy, rozpoczynać nowe zadania dla agenta oraz wyświetlać plany wdrożenia i artefakty.

Jeśli maszyna nie pojawia się w interfejsie internetowym, zgodnie z oficjalnymi instrukcjami należy sprawdzić trzy rzeczy: czy przełącznik Enable Remote Control jest włączony na komputerze, na którym działa Antigravity; czy ten komputer ma połączenie z internetem i nie przeszedł w tryb uśpienia; oraz czy aplikacja komputerowa i przeglądarka korzystają z tego samego konta Google.

Jeśli urządzenie używane do połączenia tymczasowo utraci połączenie sieciowe, interfejs internetowy spróbuje połączyć się ponownie automatycznie. Zadania agenta działające w tle i polecenia uruchomione z terminala będą bez przerwy działać na komputerze z Antigravity, o ile pozostanie on połączony z internetem.

Schemat: przełącznik Remote Control na laptopie przekazuje sterowanie telefonowi po zalogowaniu na to samo konto
Jak działa Remote Control na komputerze: włącz przełącznik na komputerze, a następnie zaloguj się na telefonie na to samo konto Google.

Dwa tryby Remote Control w Antigravity CLI

CLI ma dwa tryby: tryb interaktywny powiązany z konkretnym procesem terminala oraz działający w tle demon bez interfejsu, który pracuje bez otwartego terminala.

Tryb interaktywny: /remote-control

Możesz włączyć Remote Control w bieżącej interaktywnej sesji agy bez ponownego uruchamiania CLI. Wpisz w wierszu wejściowym:

/remote-control

Zgodnie z oficjalnym opisem CLI otwiera połączenie — tunel zwrotny — dla bieżącej sesji i wyświetla nazwę hosta oraz link do aktywnej rozmowy, z którego można skorzystać na innym urządzeniu:

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.

Otwórz ten link w przeglądarce na laptopie, tablecie lub telefonie, zaloguj się na to samo konto Google, którego używasz w CLI, i kontynuuj pracę w sesji za pośrednictwem interfejsu internetowego Antigravity.

Aby wyłączyć tunel bez kończenia lokalnej sesji terminala:

/remote-control off

Możesz uruchomić CLI z włączoną funkcją Remote Control, używając flagi podczas startu:

agy --remote-control

Tryb interaktywny jest powiązany z procesem agy: po zamknięciu CLI (/exit, Ctrl+C, Ctrl+D) albo okna terminala tunel Remote Control kończy się automatycznie, a wpis sesji znika z pulpitu nawigacyjnego. Każdy interaktywny proces CLI ma własny identyfikator sesji i nazwę hosta, więc możesz równocześnie uruchomić agy --remote-control w kilku kartach terminala lub katalogach roboczych.

Po połączeniu z interaktywną sesją CLI przez przeglądarkę obie strony synchronizują się w czasie rzeczywistym. Żądania z urządzenia zdalnego trafiają bezpośrednio do lokalnego terminala, a rozumowanie agenta, wywołania narzędzi i zmiany w kodzie są widoczne w interfejsie zdalnym. Jeśli agent zatrzyma się, aby poprosić o potwierdzenie (y/n) lub zadać dodatkowe pytanie, możesz odpowiedzieć z telefonu albo z lokalnego terminala. Ustawienia są wyjątkiem: nie można ich zmieniać z poziomu zdalnego interfejsu internetowego, a jedynie bezpośrednio w CLI.

Demon bez interfejsu: agy remote-control start

Drugi tryb to trwały demon działający w tle, który rejestruje się jako usługa systemu operacyjnego. Jest dostępny, gdy komputer jest włączony i połączony z internetem; działanie po wylogowaniu i ponownym rozruchu zależy od platformy.

agy remote-control start

Demon rejestruje się jako usługa systemu operacyjnego (usługa systemd użytkownika w systemie Linux, LaunchAgent w systemie macOS lub zaplanowane zadanie w systemie Windows) i uruchamia się od razu, bez otwartego okna terminala.

Użyj agy remote-control status, aby sprawdzić nazwę wpisu. Następnie wybierz tę maszynę w Antigravity Remote Control Dashboard i kontynuuj pracę w interfejsie internetowym Antigravity.

Demonem sterują trzy polecenia:

agy remote-control start     Zarejestruj i uruchom demona
agy remote-control status    Pokaż stan demona i nazwę instancji
agy remote-control stop      Zatrzymaj demona i wyrejestruj go

Demon korzysta z poświadczeń użytych do zalogowania się do CLI. Logowanie do CLI jest oddzielne od logowania do komputerowego edytora Antigravity na tej samej maszynie; w przeglądarce użyj tego samego konta Google co w CLI.

Możesz ustawić nazwę maszyny demona bez interfejsu za pomocą flagi --name podczas uruchamiania:

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

Ponowne uruchomienie start --name z nową wartością zmienia nazwę maszyny.

Jeśli nie ustawisz nazwy, przy pierwszym uruchomieniu demon wygeneruje łatwą do zapamiętania nazwę (na przykład my-machine-distant-plume); bieżącą nazwę pokaże agy remote-control status. Możesz też zmienić nazwę w pliku ustawień: otwórz ~/.gemini/config/config.json w systemie Linux/macOS albo %USERPROFILE%\\.gemini\\config\\config.json w systemie Windows, zmień wartość cliRemoteControlHostname, zapisz plik i ponownie uruchom demona poleceniem agy remote-control start. Nowa nazwa pojawi się na pulpicie nawigacyjnym po ponownym uruchomieniu usługi; zmiany w pliku nie są uwzględniane podczas działania demona.

W pliku znajdują się dwa podobne pola. cliRemoteControlHostname to nazwa demona CLI opisanego tutaj. remoteControlHostname jest oddzielnym polem używanym przez komputerowy edytor Antigravity na tej samej maszynie; w Antigravity 2.0 można je zmienić w Settings → App.

Działanie demona po wylogowaniu i ponownym rozruchu

Działanie zależy od systemu operacyjnego:

DziałanieLinuxmacOSWindows
UruchamianiePodczas rozruchu; logowanie nie jest wymaganePodczas logowaniaPodczas rozruchu (jeśli demon został zainstalowany przez administratora); w przeciwnym razie podczas logowania
Działa po wylogowaniuTakNie; wznowienie przy następnym logowaniuTak, jeśli skonfigurowano uruchamianie podczas rozruchu
Automatyczne wznowienie po awariiTakTakTak, maksymalnie trzy próby ponownego uruchomienia, a następnie przy kolejnym rozruchu lub po ponownym uruchomieniu agy remote-control start

Informacje dotyczące systemu Windows

Rejestracja demona do automatycznego uruchamiania podczas rozruchu systemu wymaga uprawnień administratora. Możesz użyć programu PowerShell albo zwykłego wiersza polecenia. Polecenie start zadziała również w zwykłym oknie, ale po wylogowaniu lub ponownym rozruchu demon wznowi działanie dopiero przy następnym logowaniu, a nie podczas rozruchu. Polecenia status i stop działają w zwykłym oknie bez podwyższonych uprawnień.

Który tryb wybrać

KryteriumTryb interaktywny (/remote-control / agy --remote-control)Demon bez interfejsu (agy remote-control start)
ZakresJedna interaktywna sesja terminalaCała maszyna (usługa systemowa działająca w tle)
Cykl działaniaAktywny, gdy Remote Control jest włączony, a sesja terminala działaPo wylogowaniu i ponownym rozruchu działa nadal w systemie Linux oraz w Windows, jeśli demon zainstalował administrator; w systemie macOS i przy standardowej instalacji systemu Windows wznawia działanie przy następnym logowaniu
Nazwa wpisuNowa dla każdej sesji (na przykład host-swift-falcon)Jedna stała nazwa maszyny (--name lub cliRemoteControlHostname)
Równoczesne działanieKilka sesji terminala na jednej maszynieJedna usługa demona na maszynę
Bezpośredni linkCLI wyświetla link do aktywnej rozmowyDostęp przez selektor urządzeń na antigravity.google.com
Najlepsze zastosowanieOdejdź na chwilę od aktywnego zadania w terminalu i kontynuuj pracę z telefonu lub przeglądarkiStały zdalny dostęp do stacji roboczej lub serwera, gdy maszyna jest włączona i połączona z internetem, z uwzględnieniem warunków systemu operacyjnego

Tryb interaktywny wystarczy, aby zarządzać bieżącym zadaniem z telefonu. Jeśli potrzebujesz zdalnego dostępu bez otwartego terminala, użyj demona bez interfejsu, uwzględniając ograniczenia systemu operacyjnego.

Schemat: po zamknięciu terminala tunel sesji znika; demon działający w tle pracuje bez otwartego terminala
Różnica między trybami CLI: tunel interaktywny działa tylko wtedy, gdy terminal jest otwarty; demon bez interfejsu działa bez otwartego terminala (z uwzględnieniem warunków systemu operacyjnego podanych w tabeli powyżej).

Co zrobić w razie problemów z połączeniem

Problemy i rozwiązania opisane w oficjalnej dokumentacji:

Co widziszPrzyczynaCo zrobić
Remote control is not enabled for your accountFunkcja Remote Control nie została włączona dla Twojego konta lub przez zasady organizacjiSkontaktuj się z administratorem obszaru roboczego albo sprawdź, czy Twój plan obsługuje Remote Control
Wpis znika z pulpitu nawigacyjnego (CLI)Tunele tworzone przez /remote-control i agy --remote-control rozłączają się automatycznie po zakończeniu interaktywnej sesji (/exit, Ctrl+C) lub wykonaniu /remote-control offJeśli maszyna ma być dostępna bez otwartego terminala, zainstaluj demona bez interfejsu poleceniem agy remote-control start
Na pulpicie nawigacyjnym widać kilka wpisów CLI z tej samej maszynyKażda interaktywna sesja CLI ma własną nazwę hosta; jest to normalne, gdy otwartych jest kilka terminaliNie trzeba nic robić; jest to oczekiwane działanie
Maszyna nie pojawia się na pulpicie nawigacyjnym (demon)Może występować problem z zalogowaniem się do CLIUruchom agy remote-control status; jeśli pojawi się informacja o problemie z logowaniem, uruchom agy, zaloguj się ponownie, a następnie jeszcze raz wykonaj agy remote-control start
Zmiana nazwy nie została zastosowanaNazwa jest odczytywana podczas uruchamiania demonaPonownie uruchom demona poleceniem agy remote-control start
W systemie Windows demon uruchamia się tylko przy logowaniu, a nie podczas rozruchuPolecenie start zostało uruchomione bez uprawnień administratoraPonownie uruchom agy remote-control start w oknie z podwyższonymi uprawnieniami
Połączenie ciągle się zrywa i odnawiaStary demon zainstalowany za pomocą skryptu instalacyjnego może nadal być zarejestrowany i konkurować z nowym o połączeniePonownie uruchom agy remote-control start; stara usługa zostanie automatycznie usunięta
Na pulpicie nawigacyjnym pojawiają się dwa podobne wpisy tej samej maszynyJeden wpis dotyczy edytora, a drugi demona CLI; celowo są rozdzieloneZmień nazwę jednego z nich, aby je odróżnić
Maszyna nie pojawia się na internetowym pulpicie nawigacyjnym (wersja komputerowa)Przełącznik może być wyłączony, może brakować połączenia z internetem, komputer może być uśpiony albo mogą być używane różne konta GoogleSprawdź przełącznik Enable Remote Control, połączenie komputera z internetem, czy komputer nie jest uśpiony oraz czy konto po obu stronach jest takie samo

Aby przeprowadzić dokładniejszą diagnostykę, sprawdź dzienniki demona: w systemie Linux uruchom journalctl --user -u antigravity-cli-daemon -n 50; w systemie macOS sprawdź ~/Library/Logs/antigravity-cli-daemon.log; w systemie Windows sprawdź najnowszy plik cli-*.log w %USERPROFILE%\\.gemini\\antigravity-cli\\log.

Demon bez interfejsu zapewnia dostęp bez otwartego terminala, również wtedy, gdy jesteś poza domem lub biurem, z zastrzeżeniem warunków działania komputera i systemu operacyjnego. Jeśli nie potrzebujesz już stałego dostępu, zatrzymaj demona poleceniem agy remote-control stop.

Osobny artykuł opisuje zdalne sterowanie w Claude Code. Aby sterować innym agentem przez Telegram, zobacz konfigurację Hermes Agent w Telegramie.

Co dalej

Jeśli pracujesz w CLI i chcesz odejść na chwilę od bieżącego zadania, zacznij od trybu interaktywnego. Pozostaw terminal otwarty: jeśli go zamkniesz, tunel zostanie rozłączony, a wpis sesji zniknie z pulpitu nawigacyjnego. Aby uzyskać dostęp do maszyny bez otwartego terminala, użyj demona, uwzględniając ograniczenia systemu operacyjnego.

Więcej materiałów znajdziesz na Ailoot.

Więcej szczegółów

Pytania i odpowiedzi

Dlaczego zdalna sesja znika po zamknięciu terminala?

Interaktywny Remote Control należy do działającego procesu agy, więc wyjście zamyka tunel. Dla dostępu bez terminala użyj demona headless i sprawdź warunki startu systemu operacyjnego.

Co sprawdzić, gdy komputera nie ma na dashboardzie?

Sprawdź aktywność i sieć komputera, włączenie Remote Control i to samo konto Google w przeglądarce i aplikacji lub CLI. Dla demona sprawdź problemy logowania lub usługi przez agy remote-control status.

Wszystkie artykuły