Google Antigravity Remote Control: Jak ovládat agenta z telefonu
MarkdownJak zapnout Remote Control v desktopové aplikaci Google Antigravity a v CLI: přepínač, démon agy remote-control a co dělat při problémech s připojením.
Přečíst celý článek
Dokumentace Ailoot — referenční materiály o používání služby.
Hlavní body
V desktopové aplikaci Antigravity 2.0 se funkce Remote Control zapíná přepínačem v Settings → App. K relaci se můžete připojit na antigravity.google.com pomocí stejného účtu Google. Antigravity CLI má dva režimy: /remote-control (nebo příznak --remote-control) otevře tunel po dobu relace terminálu, zatímco agy remote-control start spustí démona na pozadí bez otevřeného terminálu. V Linuxu démon běží i po odhlášení a spustí se po restartu; ve Windows vyžaduje instalaci správcem; v macOS a při standardní instalaci Windows se jeho činnost obnoví při příštím přihlášení. Počítač musí být zapnutý a připojený k internetu. Funkce nemusí být dostupná kvůli zásadám účtu nebo organizace či podmínkám tarifu.
Pokud Antigravity ještě nemáte nainstalované, začněte přehledem co je Google Antigravity a jak ho nainstalovat. Tento průvodce je určen pro chvíle, kdy agent už pracuje na dlouhém úkolu (refaktoringu, spouštění testů, migraci závislostí) a vy potřebujete odejít od stolu, ale zároveň si zachovat kontrolu nad relací.
Co je Remote Control v Google Antigravity?
Remote Control je funkce Google Antigravity, která umožňuje bezpečně se připojit k desktopovým relacím a relacím CLI na vašich počítačích a ovládat je z libovolného webového prohlížeče. Podle oficiálního popisu mohou rozsáhlé úkoly — například refaktoring celého subsystému, dlouhé spouštění testů nebo složitá migrace závislostí — trvat dlouho. Remote Control vám umožňuje spravovat relaci, když nejste u počítače, a přitom ponechat celé vývojové prostředí lokálně.
Funkce funguje v desktopové aplikaci verze 2.0 i v CLI — terminálové verzi Antigravity (agy) — v každé se však zapíná jinak a funguje odlišným způsobem.
Zapnutí Remote Control v desktopové aplikaci Antigravity 2.0
Remote Control můžete zapnout v nastavení aplikace:
- Otevřete panel Settings stisknutím
Cmd + ,(v Linuxu a WindowsCtrl + ,), nebo klikněte na tlačítko Settings v dolní části levého panelu. - Přejděte do části App.
- Přepněte Enable Remote Control do polohy On.
- (Volitelné) Nastavte Nickname, například
workstation-primaryneboserver-machine, abyste tento počítač snadno poznali v seznamu připojených zařízení.
Připojení z telefonu nebo jiného prohlížeče
Vzdálenou relaci otevřete takto:
- Na libovolném zařízení otevřete prohlížeč a přejděte na Antigravity Remote Control Dashboard. V telefonu si také můžete webovou aplikaci nainstalovat na domovskou obrazovku, abyste dostávali oznámení push, když agent dokončí úkol nebo vás požádá o odpověď.
- Přihlaste se stejným účtem Google, který používáte na počítači.
- V přepínači zařízení vyberte požadovaný počítač.
- Po připojení můžete zobrazit aktivní konverzace, zadávat agentovi nové úkoly a prohlížet plány implementace a artefakty.
Pokud se počítač ve webovém rozhraní nezobrazí, podle oficiálních pokynů zkontrolujte tři věci: zda je na počítači s Antigravity zapnutý přepínač Enable Remote Control; zda je počítač připojený k internetu a nepřešel do režimu spánku; a zda desktopová aplikace i prohlížeč používají stejný účet Google.
Pokud zařízení, ze kterého se připojujete, dočasně ztratí síťové připojení, webové rozhraní se pokusí připojit znovu automaticky. Úlohy agenta na pozadí a příkazy spuštěné z terminálu budou na počítači s Antigravity pokračovat bez přerušení, pokud zůstane připojený k internetu.
Dva režimy Remote Control v Antigravity CLI
CLI má dva režimy: interaktivní režim vázaný na konkrétní proces terminálu a bezhlavého démona na pozadí, který běží bez otevřeného terminálu.
Interaktivní režim: /remote-control
Remote Control můžete zapnout v aktuální interaktivní relaci agy bez restartování CLI. Zadejte na vstupním řádku:
/remote-control
Podle oficiálního popisu CLI otevře pro aktuální relaci připojení — reverzní tunel — a vypíše název hostitele spolu s odkazem na aktivní konverzaci, který můžete otevřít na jiném zařízení:
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.
Otevřete tento odkaz v prohlížeči na notebooku, tabletu nebo telefonu, přihlaste se stejným účtem Google, který používáte v CLI, a pokračujte v práci v relaci přes webové rozhraní Antigravity.
Tunel vypnete, aniž byste ukončili místní relaci terminálu, takto:
/remote-control off
CLI můžete spustit s již zapnutou funkcí Remote Control pomocí příznaku při spuštění:
agy --remote-control
Interaktivní režim je vázán na proces agy: když CLI ukončíte (/exit, Ctrl+C, Ctrl+D) nebo zavřete okno terminálu, tunel Remote Control se automaticky ukončí a položka relace zmizí z řídicího panelu. Každý interaktivní proces CLI má vlastní ID relace a název hostitele, takže můžete současně spustit agy --remote-control v několika kartách terminálu nebo pracovních adresářích.
Když se z prohlížeče připojíte k interaktivní relaci CLI, obě strany se synchronizují v reálném čase. Požadavky ze vzdáleného zařízení míří přímo do místního terminálu, zatímco uvažování agenta, volání nástrojů a změny kódu jsou viditelné ve vzdáleném rozhraní. Pokud se agent pozastaví, aby požádal o potvrzení (y/n) nebo položil doplňující otázku, můžete odpovědět z telefonu nebo místního terminálu. Výjimkou jsou nastavení: ve vzdáleném webovém rozhraní je změnit nemůžete, pouze přímo v CLI.
Bezhlavý démon: agy remote-control start
Druhým režimem je trvalý démon na pozadí, který se zaregistruje jako služba operačního systému. Je dostupný, když je počítač zapnutý a připojený k internetu; chování po odhlášení a restartu závisí na platformě.
agy remote-control start
Démon se zaregistruje jako služba operačního systému (uživatelská služba systemd v Linuxu, LaunchAgent v macOS nebo naplánovaná úloha ve Windows) a okamžitě se spustí bez otevřeného okna terminálu.
Pomocí agy remote-control status zjistíte název položky. Poté vyberte tento počítač na Antigravity Remote Control Dashboard a pokračujte v práci přes webové rozhraní Antigravity.
Démon ovládají tři příkazy:
agy remote-control start Zaregistrovat a spustit démona
agy remote-control status Zobrazit stav démona a název instance
agy remote-control stop Zastavit démona a zrušit jeho registraci
Démon používá přihlašovací údaje, které jste použili při přihlášení do CLI. Přihlášení do CLI je oddělené od přihlášení do desktopového editoru Antigravity na stejném počítači; v prohlížeči použijte stejný účet Google jako v CLI.
Název počítače pro bezhlavého démona můžete nastavit pomocí příznaku --name při spuštění:
agy remote-control start --name "my-workstation"
Opětovným spuštěním start --name s novou hodnotou název počítače změníte.
Pokud název nenastavíte, démon při prvním spuštění vygeneruje snadno zapamatovatelný název (například my-machine-distant-plume); aktuální název zobrazí agy remote-control status. Název můžete změnit také v souboru nastavení: v Linuxu/macOS otevřete ~/.gemini/config/config.json, ve Windows %USERPROFILE%\\.gemini\\config\\config.json, změňte hodnotu cliRemoteControlHostname, soubor uložte a opětovným spuštěním agy remote-control start démona restartujte. Nový název se na řídicím panelu zobrazí po restartu služby; změny souboru se za běhu démona neprojeví.
V souboru jsou dvě podobná pole. cliRemoteControlHostname je název démona CLI popsaného zde. remoteControlHostname je samostatné pole pro desktopový editor Antigravity na stejném počítači; v Antigravity 2.0 ho můžete změnit v Settings → App.
Chování démona po odhlášení a restartu
Chování závisí na operačním systému:
| Chování | Linux | macOS | Windows |
|---|---|---|---|
| Spuštění | Při startu systému; přihlášení není potřeba | Při přihlášení | Při startu systému (pokud instalaci provedl správce); jinak při přihlášení |
| Běží po odhlášení | Ano | Ne; obnoví se při příštím přihlášení | Ano, pokud je nakonfigurován pro spuštění při startu systému |
| Automaticky se obnoví po selhání | Ano | Ano | Ano, až tři pokusy o restart, poté při dalším spuštění systému nebo při opětovném spuštění agy remote-control start |
Podrobnosti pro Windows
Registrace démona ke spouštění při startu systému vyžaduje spuštění s oprávněními správce. Můžete použít PowerShell nebo běžný příkazový řádek. Příkaz start bude fungovat i v běžném okně, ale po odhlášení nebo restartu systému se démon obnoví až při příštím přihlášení, nikoli při startu systému. Příkazy status a stop fungují v běžném okně bez zvýšených oprávnění.
Který režim zvolit
| Kritérium | Interaktivní (/remote-control / agy --remote-control) | Bezhlavý démon (agy remote-control start) |
|---|---|---|
| Rozsah | Jedna interaktivní relace terminálu | Celý počítač (služba operačního systému na pozadí) |
| Životní cyklus | Aktivní, když je Remote Control zapnutý a relace terminálu běží | Přežije odhlášení a restart v Linuxu a ve Windows, pokud ho nainstaloval správce; v macOS a při standardní instalaci Windows se obnoví při příštím přihlášení |
| Název položky | Nový pro každou relaci (například host-swift-falcon) | Jeden trvalý název počítače (--name nebo cliRemoteControlHostname) |
| Souběžný běh | Na jednom počítači může běžet několik relací terminálu současně | Jedna služba démona na počítač |
| Přímý odkaz | CLI vypíše odkaz na aktivní konverzaci | Přístup přes přepínač zařízení na antigravity.google.com |
| Vhodné pro | Odejít od právě probíhajícího úkolu v terminálu a pokračovat z telefonu nebo prohlížeče | Trvalý vzdálený přístup k pracovní stanici nebo serveru, když je počítač zapnutý a připojený k internetu, s ohledem na podmínky operačního systému |
Interaktivní režim stačí ke správě aktuálního úkolu z telefonu. Pokud potřebujete vzdálený přístup bez otevřeného terminálu, použijte bezhlavého démona s ohledem na podmínky svého operačního systému.
Co dělat, když se Antigravity Remote Control nepřipojí?
Problémy a řešení podle oficiální dokumentace:
| Co vidíte | Proč | Co dělat |
|---|---|---|
Remote control is not enabled for your account | Funkce Remote Control není povolena pro váš účet nebo podle zásad organizace | Obraťte se na správce svého pracovního prostoru nebo ověřte, zda váš tarif Remote Control podporuje |
| Položka zmizí z řídicího panelu (CLI) | Tunely vytvořené pomocí /remote-control a agy --remote-control se automaticky odpojí, když ukončíte interaktivní relaci (/exit, Ctrl+C) nebo spustíte /remote-control off | Pokud má počítač zůstat dostupný bez otevřeného terminálu, nainstalujte bezhlavého démona příkazem agy remote-control start |
| Na řídicím panelu se zobrazí několik položek CLI ze stejného počítače | Každá interaktivní relace CLI má vlastní název hostitele; pokud je otevřeno několik terminálů, jde o normální chování | Není třeba nic dělat; jde o očekávané chování |
| Počítač se na řídicím panelu nezobrazuje (démon) | Může být problém s přihlášením do CLI | Spusťte agy remote-control status; pokud oznámí problém s přihlášením, spusťte agy, znovu se přihlaste a pak znovu spusťte agy remote-control start |
| Přejmenování se neprojevilo | Název se načítá při spuštění démona | Démon restartujte opětovným spuštěním agy remote-control start |
| Ve Windows se démon spouští pouze při přihlášení, nikoli při startu systému | Příkaz start byl spuštěn bez oprávnění správce | Znovu spusťte agy remote-control start v okně se zvýšenými oprávněními |
| Připojení se stále přerušuje a obnovuje | Může být stále zaregistrovaný starý démon nainstalovaný pomocí instalačního skriptu a soupeřit s novým o připojení | Znovu spusťte agy remote-control start; stará služba se automaticky odebere |
| Na řídicím panelu se zobrazují dvě podobné položky jednoho počítače | Jedna položka patří editoru a druhá démonu CLI; záměrně jsou oddělené | Přejmenujte tu, kterou potřebujete rozlišit |
| Počítač se nezobrazuje na webovém řídicím panelu (desktopová aplikace) | Přepínač může být vypnutý, nemusí být dostupné připojení k internetu, počítač může být v režimu spánku nebo se mohou používat různá účty Google | Zkontrolujte přepínač Enable Remote Control, připojení počítače k internetu, zda není v režimu spánku, a zda se na obou stranách používá stejný účet |
Podrobnější diagnostiku provedete kontrolou protokolů démona: v Linuxu spusťte journalctl --user -u antigravity-cli-daemon -n 50; v macOS zkontrolujte ~/Library/Logs/antigravity-cli-daemon.log; ve Windows zkontrolujte nejnovější soubor cli-*.log v %USERPROFILE%\\.gemini\\antigravity-cli\\log.
Bezhlavý démon umožňuje přístup bez otevřeného terminálu, i když jste pryč, s ohledem na provozní podmínky počítače a operačního systému. Pokud už trvalý přístup nepotřebujete, zastavte démona příkazem agy remote-control stop.
Samostatný článek se věnuje vzdálenému ovládání v Claude Code. Chcete-li ovládat jiného agenta přes Telegram, podívejte se na nastavení Hermes Agent v Telegramu.
Co dál
Pokud pracujete v CLI a chcete na chvíli odejít od aktuálního úkolu, začněte interaktivním režimem. Nechte terminál otevřený: když ho zavřete, tunel se odpojí a položka relace zmizí z řídicího panelu. Chcete-li k počítači přistupovat bez otevřeného terminálu, použijte démona s ohledem na omezení svého operačního systému.
Zdroje
Další materiály najdete na Ailoot.
Další podrobnosti
Časté otázky
Proč vzdálená relace zmizí po zavření terminálu?
Interaktivní Remote Control patří běžícímu procesu agy, takže jeho ukončení zavře tunel. Pro přístup bez otevřeného terminálu použijte bezobslužného démona a ověřte podmínky jeho spouštění v operačním systému.
Co ověřit, když se počítač nezobrazuje na dashboardu?
Ověřte, že je počítač vzhůru a online, Remote Control je zapnuté a prohlížeč používá stejný účet Google jako desktop či CLI. U relace démona prohlédněte agy remote-control status kvůli přihlášení a službě.