Google Antigravity Remote Control: jak sterować agentem z telefonu
MarkdownJak 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:
- Otwórz panel Settings, naciskając
Cmd + ,(lubCtrl + ,w systemach Linux i Windows), albo kliknij przycisk Settings u dołu lewego panelu. - Przejdź do sekcji App.
- Przestaw Enable Remote Control na On.
- (Opcjonalnie) Ustaw Nickname, na przykład
workstation-primarylubserver-machine, aby łatwo rozpoznawać tę maszynę na liście połączonych urządzeń.
Łączenie z telefonu lub innej przeglądarki
Aby otworzyć sesję zdalną:
- 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ź.
- Zaloguj się na to samo konto Google, którego używasz na komputerze.
- W selektorze urządzeń wybierz odpowiednią maszynę.
- 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.
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łanie | Linux | macOS | Windows |
|---|---|---|---|
| Uruchamianie | Podczas rozruchu; logowanie nie jest wymagane | Podczas logowania | Podczas rozruchu (jeśli demon został zainstalowany przez administratora); w przeciwnym razie podczas logowania |
| Działa po wylogowaniu | Tak | Nie; wznowienie przy następnym logowaniu | Tak, jeśli skonfigurowano uruchamianie podczas rozruchu |
| Automatyczne wznowienie po awarii | Tak | Tak | Tak, 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ć
| Kryterium | Tryb interaktywny (/remote-control / agy --remote-control) | Demon bez interfejsu (agy remote-control start) |
|---|---|---|
| Zakres | Jedna interaktywna sesja terminala | Cała maszyna (usługa systemowa działająca w tle) |
| Cykl działania | Aktywny, gdy Remote Control jest włączony, a sesja terminala działa | Po 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 wpisu | Nowa dla każdej sesji (na przykład host-swift-falcon) | Jedna stała nazwa maszyny (--name lub cliRemoteControlHostname) |
| Równoczesne działanie | Kilka sesji terminala na jednej maszynie | Jedna usługa demona na maszynę |
| Bezpośredni link | CLI wyświetla link do aktywnej rozmowy | Dostęp przez selektor urządzeń na antigravity.google.com |
| Najlepsze zastosowanie | Odejdź na chwilę od aktywnego zadania w terminalu i kontynuuj pracę z telefonu lub przeglądarki | Stał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.
Co zrobić w razie problemów z połączeniem
Problemy i rozwiązania opisane w oficjalnej dokumentacji:
| Co widzisz | Przyczyna | Co zrobić |
|---|---|---|
Remote control is not enabled for your account | Funkcja Remote Control nie została włączona dla Twojego konta lub przez zasady organizacji | Skontaktuj 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 off | Jeś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 maszyny | Każda interaktywna sesja CLI ma własną nazwę hosta; jest to normalne, gdy otwartych jest kilka terminali | Nie 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 CLI | Uruchom 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 zastosowana | Nazwa jest odczytywana podczas uruchamiania demona | Ponownie uruchom demona poleceniem agy remote-control start |
| W systemie Windows demon uruchamia się tylko przy logowaniu, a nie podczas rozruchu | Polecenie start zostało uruchomione bez uprawnień administratora | Ponownie uruchom agy remote-control start w oknie z podwyższonymi uprawnieniami |
| Połączenie ciągle się zrywa i odnawia | Stary demon zainstalowany za pomocą skryptu instalacyjnego może nadal być zarejestrowany i konkurować z nowym o połączenie | Ponownie uruchom agy remote-control start; stara usługa zostanie automatycznie usunięta |
| Na pulpicie nawigacyjnym pojawiają się dwa podobne wpisy tej samej maszyny | Jeden wpis dotyczy edytora, a drugi demona CLI; celowo są rozdzielone | Zmień 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 Google | Sprawdź 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.
Źródła
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.