Google Antigravity Remote Control: Ako ovládať agenta z telefónu
MarkdownAko zapnúť Remote Control v Google Antigravity na počítači a v CLI: prepínač, démon agy remote-control a postup pri problémoch s pripojením.
Prečítať celý článok
Dokumentácia Ailoot — referenčné materiály o používaní služby.
Hlavné body
V desktopovej aplikácii Antigravity 2.0 sa Remote Control zapína prepínačom v časti Settings → App. K relácii sa môžete pripojiť na antigravity.google.com pomocou rovnakého účtu Google. Antigravity CLI má dva režimy: /remote-control (alebo príznak --remote-control) otvorí tunel na dobu trvania relácie terminálu, zatiaľ čo agy remote-control start spustí démona na pozadí bez otvoreného terminálu. V systéme Linux démon beží aj po odhlásení a spustí sa po reštarte; vo Windows to vyžaduje inštaláciu správcom; v systéme macOS a pri štandardnej inštalácii Windows sa obnoví pri ďalšom prihlásení. Počítač musí byť zapnutý a pripojený na internet. Funkcia nemusí byť dostupná z dôvodu pravidiel účtu alebo organizácie, prípadne podmienok programu.
Ak ste Antigravity ešte nenainštalovali, začnite prehľadom o tom, čo je Google Antigravity a ako ho nainštalovať. Tento návod je určený pre situáciu, keď agent už vykonáva dlhú úlohu (refaktoring, spúšťanie testov, migráciu závislostí) a vy potrebujete odísť od stola, no zároveň si zachovať kontrolu nad reláciou.
Čo je Remote Control a prečo ho potrebujete
Remote Control je funkcia Google Antigravity, ktorá vám umožňuje bezpečne sa pripojiť k reláciám v počítačovej aplikácii a CLI na vašich zariadeniach a ovládať ich z ľubovoľného webového prehliadača. Podľa oficiálneho opisu môžu rozsiahle úlohy — napríklad refaktoring celého podsystému, dlhé spúšťanie testov alebo zložitá migrácia závislostí — trvať dlho. Remote Control vám umožňuje spravovať reláciu, keď ste mimo počítača, pričom celé vývojové prostredie zostáva lokálne.
Funkcia funguje v počítačovej aplikácii 2.0 aj v CLI — terminálovej verzii Antigravity (agy) — no v každej sa zapína a správa odlišne.
Zapnutie Remote Control v desktopovej aplikácii Antigravity 2.0
Remote Control môžete zapnúť v nastaveniach aplikácie:
- Otvorte panel Settings pomocou
Cmd + ,(aleboCtrl + ,v systémoch Linux a Windows), prípadne kliknite na tlačidlo Settings v dolnej časti ľavého panela. - Prejdite do časti App.
- Prepnite Enable Remote Control na On.
- (Voliteľné) Nastavte Nickname, napríklad
workstation-primaryaleboserver-machine, aby ste toto zariadenie ľahko rozpoznali v zozname pripojených zariadení.
Pripojenie z telefónu alebo iného prehliadača
Ak chcete otvoriť vzdialenú reláciu:
- Otvorte prehliadač na ľubovoľnom zariadení a prejdite na ovládací panel Antigravity Remote Control. V telefóne si môžete webovú aplikáciu nainštalovať aj na domovskú obrazovku, aby ste dostávali push notifikácie, keď agent dokončí úlohu alebo požiada o vašu odpoveď.
- Prihláste sa pomocou rovnakého účtu Google, ktorý používate na počítači.
- V prepínači zariadení vyberte požadovaný počítač.
- Po pripojení uvidíte aktívne konverzácie; môžete agentovi zadávať nové úlohy a prezerať si plány implementácie a artefakty.
Ak sa zariadenie nezobrazí vo webovom rozhraní, podľa oficiálnych pokynov treba skontrolovať tri veci: či je na počítači so spustenou aplikáciou Antigravity zapnutý prepínač Enable Remote Control; či je počítač pripojený na internet a neprešiel do režimu spánku; a či desktopová aplikácia aj prehliadač používajú rovnaký účet Google.
Ak sa sieťové pripojenie na zariadení, z ktorého sa pripájate, dočasne preruší, webové rozhranie sa pokúsi automaticky znova pripojiť. Úlohy agenta na pozadí a príkazy spustené z terminálu budú na počítači s Antigravity pokračovať bez prerušenia, pokiaľ zostane pripojený na internet.
Dva režimy Remote Control v Antigravity CLI
CLI má dva režimy: interaktívny režim naviazaný na konkrétny proces terminálu a bezhlavý démon na pozadí, ktorý beží bez otvoreného terminálu.
Interaktívny režim: /remote-control
Remote Control môžete zapnúť v aktuálnej interaktívnej relácii agy bez reštartovania CLI. Zadajte do vstupného riadka:
/remote-control
Podľa oficiálneho opisu CLI otvorí pripojenie — spätný tunel — pre aktuálnu reláciu a vypíše názov hostiteľa spolu s odkazom na aktívnu konverzáciu, ktorý môžete otvoriť na inom zariadení:
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.
Otvorte tento odkaz v prehliadači na notebooku, tablete alebo telefóne, prihláste sa pomocou rovnakého účtu Google ako v CLI a pokračujte v práci s reláciou cez webové rozhranie Antigravity.
Ak chcete tunel vypnúť bez ukončenia lokálnej relácie terminálu:
/remote-control off
CLI môžete spustiť s už zapnutým Remote Control pomocou príznaku pri spustení:
agy --remote-control
Interaktívny režim je naviazaný na proces agy: keď ukončíte CLI (/exit, Ctrl+C, Ctrl+D) alebo zatvoríte okno terminálu, tunel Remote Control sa automaticky ukončí a položka relácie zmizne z ovládacieho panela. Každý interaktívny proces CLI má vlastné ID relácie a názov hostiteľa, takže môžete súčasne spustiť agy --remote-control vo viacerých kartách terminálu alebo pracovných adresároch.
Keď sa k interaktívnej relácii CLI pripojíte z prehliadača, obe strany sa synchronizujú v reálnom čase. Požiadavky zo vzdialeného zariadenia smerujú priamo do lokálneho terminálu, zatiaľ čo uvažovanie agenta, volania nástrojov a zmeny kódu sú viditeľné vo vzdialenom rozhraní. Ak sa agent pozastaví a požiada o potvrdenie (y/n) alebo položí doplňujúcu otázku, môžete odpovedať z telefónu alebo lokálneho terminálu. Výnimkou sú nastavenia: meniť ich nemožno vo vzdialenom webovom rozhraní, iba priamo v CLI.
Bezhlavý démon: agy remote-control start
Druhým režimom je trvalý démon na pozadí, ktorý sa zaregistruje ako služba operačného systému. Je dostupný, kým je počítač zapnutý a pripojený na internet; správanie po odhlásení a reštarte závisí od platformy.
agy remote-control start
Démon sa zaregistruje ako služba operačného systému (používateľská služba systemd v systéme Linux, LaunchAgent v systéme macOS alebo naplánovaná úloha v systéme Windows) a okamžite sa spustí bez otvoreného okna terminálu.
Pomocou príkazu agy remote-control status zistíte názov položky. Potom vyberte tento počítač na ovládacom paneli Antigravity Remote Control a pokračujte v práci cez webové rozhranie Antigravity.
Démona ovládajú tri príkazy:
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
Démon používa prihlasovacie údaje, ktorými ste sa prihlásili do CLI. Prihlásenie do CLI je oddelené od prihlásenia do desktopového editora Antigravity na tom istom počítači; v prehliadači použite rovnaký účet Google ako v CLI.
Názov počítača bezhlavého démona môžete nastaviť príznakom --name pri spustení:
agy remote-control start --name "my-workstation"
Opätovným spustením start --name s novou hodnotou názov počítača zmeníte.
Ak názov nenastavíte, démon pri prvom spustení vygeneruje zapamätateľný názov (napríklad my-machine-distant-plume); aktuálny názov zobrazí agy remote-control status. Premenovať ho môžete aj v súbore nastavení: v systéme Linux/macOS otvorte ~/.gemini/config/config.json alebo vo Windows %USERPROFILE%\.gemini\config\config.json, zmeňte hodnotu cliRemoteControlHostname, uložte súbor a znova spustite agy remote-control start, aby sa démon reštartoval. Nový názov sa na ovládacom paneli zobrazí po reštarte služby; zmeny súboru sa počas behu démona neprejavia.
V súbore sú dve podobné polia. cliRemoteControlHostname je názov démona CLI, o ktorom sa hovorí tu. remoteControlHostname je samostatné pole pre desktopový editor Antigravity na tom istom počítači; v Antigravity 2.0 ho môžete zmeniť v časti Settings → App.
Správanie démona po odhlásení a reštarte
Správanie závisí od operačného systému:
| Správanie | Linux | macOS | Windows |
|---|---|---|---|
| Spustenie | Pri štarte systému; prihlásenie nie je potrebné | Pri prihlásení | Pri štarte systému (ak ho nainštaloval správca); inak pri prihlásení |
| Beží po odhlásení | Áno | Nie; obnoví sa pri ďalšom prihlásení | Áno, ak je nastavený na spustenie pri štarte systému |
| Automaticky sa obnoví po zlyhaní | Áno | Áno | Áno, najviac tri pokusy o reštart, potom pri ďalšom spustení systému alebo pri opätovnom spustení agy remote-control start |
Podrobnosti pre Windows
Registrácia démona na automatické spustenie pri štarte systému vyžaduje spustenie s oprávneniami správcu. Môžete použiť PowerShell alebo bežný príkazový riadok. Príkaz start funguje aj v bežnom okne, no po odhlásení alebo reštarte sa démon obnoví až pri ďalšom prihlásení, nie pri štarte systému. Príkazy status a stop fungujú v bežnom okne bez zvýšených oprávnení.
Ktorý režim si vybrať
| Kritérium | Interaktívny (/remote-control / agy --remote-control) | Bezhlavý démon (agy remote-control start) |
|---|---|---|
| Rozsah | Jedna interaktívna relácia terminálu | Celý počítač (služba operačného systému na pozadí) |
| Životný cyklus | Aktívny, keď je zapnutý Remote Control a beží relácia terminálu | Pretrváva po odhlásení a reštarte v systéme Linux a vo Windows, ak ho nainštaloval správca; v systéme macOS a pri štandardnej inštalácii Windows sa obnoví pri ďalšom prihlásení |
| Názov položky | Nový pre každú reláciu (napríklad host-swift-falcon) | Jeden trvalý názov počítača (--name alebo cliRemoteControlHostname) |
| Súbežnosť | Viacero relácií terminálu naraz na jednom počítači | Jedna služba démona na počítač |
| Priamy odkaz | CLI vypíše odkaz na aktívnu konverzáciu | Prístup cez prepínač zariadení na antigravity.google.com |
| Vhodný na | Odchod od úlohy v aktívnom termináli a pokračovanie z telefónu alebo prehliadača | Trvalý vzdialený prístup k pracovnej stanici alebo serveru, kým je počítač zapnutý a pripojený na internet, podľa podmienok operačného systému |
Na správu aktuálnej úlohy z telefónu stačí interaktívny režim. Ak potrebujete vzdialený prístup bez otvoreného terminálu, použite bezhlavého démona s ohľadom na podmienky operačného systému.
Čo robiť pri problémoch s pripojením
Problémy a riešenia podľa oficiálnej dokumentácie:
| Čo vidíte | Prečo | Čo robiť |
|---|---|---|
Remote control is not enabled for your account | Vo vašom účte alebo podľa pravidiel organizácie nie je povolená funkcia Remote Control | Kontaktujte správcu pracovného priestoru alebo si overte, či váš program podporuje Remote Control |
| Položka zmizne z ovládacieho panela (CLI) | /remote-control a agy --remote-control vytvárajú tunely, ktoré sa automaticky odpoja po ukončení interaktívnej relácie (/exit, Ctrl+C) alebo po spustení /remote-control off | Ak potrebujete, aby počítač zostal dostupný bez otvoreného terminálu, nainštalujte bezhlavého démona pomocou agy remote-control start |
| Na ovládacom paneli sa zobrazí viacero položiek CLI z toho istého počítača | Každá interaktívna relácia CLI má vlastný názov hostiteľa; pri otvorených viacerých termináloch je to normálne | Nie je potrebný žiadny zásah; ide o očakávané správanie |
| Počítač sa nezobrazí na ovládacom paneli (démon) | Môže ísť o problém s prihlásením do CLI | Spustite agy remote-control status; ak oznámi problém s prihlásením, spustite agy, znova sa prihláste a potom ešte raz spustite agy remote-control start |
| Premenovanie sa neprejavilo | Názov sa načíta pri spustení démona | Znova spustite agy remote-control start, aby sa démon reštartoval |
| Vo Windows sa démon spúšťa iba pri prihlásení, nie pri štarte systému | Príkaz start bol spustený bez oprávnení správcu | Znova spustite agy remote-control start v okne so zvýšenými oprávneniami |
| Pripojenie sa opakovane prerušuje a obnovuje | Stará verzia démona nainštalovaná pomocou inštalačného skriptu môže byť stále zaregistrovaná a súperiť s novou o pripojenie | Znova spustite agy remote-control start; stará služba sa automaticky odstráni |
| Na ovládacom paneli sa zobrazia dve podobné položky toho istého počítača | Jedna položka patrí editoru a druhá démonovi CLI; ide zámerne o samostatné položky | Premenujte tú, ktorú potrebujete rozlíšiť |
| Počítač sa nezobrazí na webovom ovládacom paneli (desktop) | Prepínač môže byť vypnutý, nemusí byť dostupné internetové pripojenie, počítač môže byť v režime spánku alebo sa používajú rôzne účty Google | Skontrolujte prepínač Enable Remote Control, internetové pripojenie počítača, či nie je v režime spánku, a či sa na oboch stranách používa rovnaký účet |
Ak potrebujete podrobnejšiu diagnostiku, skontrolujte protokoly démona: v systéme Linux spustite journalctl --user -u antigravity-cli-daemon -n 50; v systéme macOS skontrolujte ~/Library/Logs/antigravity-cli-daemon.log; vo Windows skontrolujte najnovší súbor cli-*.log v %USERPROFILE%\.gemini\antigravity-cli\log.
Bezhlavý démon poskytuje prístup bez otvoreného terminálu aj vtedy, keď ste preč, s ohľadom na prevádzkové podmienky počítača a operačného systému. Ak už trvalý prístup nepotrebujete, zastavte démona príkazom agy remote-control stop.
Samostatný článok sa venuje vzdialenému ovládaniu v Claude Code. Ak chcete ovládať iného agenta cez Telegram, pozrite si nastavenie Hermes Agent v Telegrame.
Čo ďalej
Ak pracujete v CLI a chcete odísť od aktuálnej úlohy, začnite interaktívnym režimom. Nechajte terminál otvorený: ak ho zatvoríte, tunel sa odpojí a položka relácie zmizne z ovládacieho panela. Ak chcete pristupovať k počítaču bez otvoreného terminálu, použite démona s ohľadom na obmedzenia operačného systému.
Zdroje
Ďalšie materiály nájdete na Ailoot.
Viac podrobností
Otázky a odpovede: Google Antigravity Remote Control: Ako ovládať agenta z telefónu
Prečo vzdialená relácia zmizne po zatvorení terminálu?
Interaktívny Remote Control patrí bežiacemu procesu agy, preto jeho ukončenie zatvorí tunel. Pre prístup bez otvoreného terminálu použite headless daemon a overte podmienky jeho spúšťania operačným systémom.
Čo overiť, ak zariadenie chýba v dashboarde?
Overte bdelé a online zariadenie, zapnutý Remote Control a rovnaký účet Google v prehliadači aj desktope či CLI. Pri daemon relácii prezrite agy remote-control status pre problémy prihlásenia či služby.