Blog

Google Antigravity Remote Control: Jak ovládat agenta z telefonu

Markdown

Jak 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:

  1. Otevřete panel Settings stisknutím Cmd + , (v Linuxu a Windows Ctrl + ,), nebo klikněte na tlačítko Settings v dolní části levého panelu.
  2. Přejděte do části App.
  3. Přepněte Enable Remote Control do polohy On.
  4. (Volitelné) Nastavte Nickname, například workstation-primary nebo server-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:

  1. 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ěď.
  2. Přihlaste se stejným účtem Google, který používáte na počítači.
  3. V přepínači zařízení vyberte požadovaný počítač.
  4. 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.

Schéma: přepínač Remote Control na notebooku předá ovládání telefonu po přihlášení ke stejnému účtu
Jak funguje Remote Control na počítači: zapněte přepínač na počítači a pak se na telefonu přihlaste ke stejnému účtu Google.

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íLinuxmacOSWindows
SpuštěníPři startu systému; přihlášení není potřebaPři přihlášeníPři startu systému (pokud instalaci provedl správce); jinak při přihlášení
Běží po odhlášeníAnoNe; 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íAnoAnoAno, 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ériumInteraktivní (/remote-control / agy --remote-control)Bezhlavý démon (agy remote-control start)
RozsahJedna interaktivní relace termináluCelý počítač (služba operačního systému na pozadí)
Životní cyklusAktivní, 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žkyNový pro každou relaci (například host-swift-falcon)Jeden trvalý název počítače (--name nebo cliRemoteControlHostname)
Souběžný běhNa 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ý odkazCLI vypíše odkaz na aktivní konverzaciPřístup přes přepínač zařízení na antigravity.google.com
Vhodné proOdejít od právě probíhajícího úkolu v terminálu a pokračovat z telefonu nebo prohlížečeTrvalý 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.

Schéma: po zavření terminálu tunel relace zmizí; démon na pozadí běží bez otevřeného terminálu
Rozdíl mezi režimy CLI: interaktivní tunel běží pouze po dobu, kdy je terminál otevřený; bezhlavý démon běží i bez otevřeného terminálu (v závislosti na podmínkách operačního systému uvedených v tabulce výše).

Co dělat, když se Antigravity Remote Control nepřipojí?

Problémy a řešení podle oficiální dokumentace:

Co vidítePročCo dělat
Remote control is not enabled for your accountFunkce Remote Control není povolena pro váš účet nebo podle zásad organizaceObrať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 offPokud 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čeKaž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 CLISpusť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 neprojeviloNázev se načítá při spuštění démonaDé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émuPříkaz start byl spuštěn bez oprávnění správceZnovu 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 obnovujeMůž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čeJedna 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 GoogleZkontrolujte 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.

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ě.

Všechny články