Blog

Google Antigravity Remote Control: Ako ovládať agenta z telefónu

Markdown

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

  1. Otvorte panel Settings pomocou Cmd + , (alebo Ctrl + , v systémoch Linux a Windows), prípadne kliknite na tlačidlo Settings v dolnej časti ľavého panela.
  2. Prejdite do časti App.
  3. Prepnite Enable Remote Control na On.
  4. (Voliteľné) Nastavte Nickname, napríklad workstation-primary alebo server-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:

  1. 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ď.
  2. Prihláste sa pomocou rovnakého účtu Google, ktorý používate na počítači.
  3. V prepínači zariadení vyberte požadovaný počítač.
  4. 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.

Diagram: prepínač Remote Control na notebooku prenesie ovládanie do telefónu po prihlásení pomocou rovnakého účtu
Ako funguje Remote Control na počítači: zapnite prepínač na počítači a potom sa prihláste v telefóne pomocou rovnakého účtu Google.

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ávanieLinuxmacOSWindows
SpusteniePri š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íÁnoNie; 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ériumInteraktívny (/remote-control / agy --remote-control)Bezhlavý démon (agy remote-control start)
RozsahJedna interaktívna relácia termináluCelý počítač (služba operačného systému na pozadí)
Životný cyklusAktívny, keď je zapnutý Remote Control a beží relácia termináluPretrvá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žkyNový 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čiJedna služba démona na počítač
Priamy odkazCLI vypíše odkaz na aktívnu konverzáciuPrístup cez prepínač zariadení na antigravity.google.com
Vhodný naOdchod od úlohy v aktívnom termináli a pokračovanie z telefónu alebo prehliadačaTrvalý 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.

Diagram: po zatvorení terminálu tunel relácie zmizne; démon na pozadí beží bez otvoreného terminálu
Rozdiel medzi režimami CLI: interaktívny tunel beží iba vtedy, keď je terminál otvorený; bezhlavý démon beží bez otvoreného terminálu (podľa podmienok operačného systému v tabuľke vyššie).

Čo robiť pri problémoch s pripojením

Problémy a riešenia podľa oficiálnej dokumentácie:

Čo vidítePrečoČo robiť
Remote control is not enabled for your accountVo vašom účte alebo podľa pravidiel organizácie nie je povolená funkcia Remote ControlKontaktujte 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 offAk 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čaKaždá interaktívna relácia CLI má vlastný názov hostiteľa; pri otvorených viacerých termináloch je to normálneNie 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 CLISpustite 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 neprejaviloNázov sa načíta pri spustení démonaZnova 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émuPríkaz start bol spustený bez oprávnení správcuZnova spustite agy remote-control start v okne so zvýšenými oprávneniami
Pripojenie sa opakovane prerušuje a obnovujeStará verzia démona nainštalovaná pomocou inštalačného skriptu môže byť stále zaregistrovaná a súperiť s novou o pripojenieZnova 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čaJedna položka patrí editoru a druhá démonovi CLI; ide zámerne o samostatné položkyPremenujte 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 GoogleSkontrolujte 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.

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

Všetky články