Blog

Google Antigravity Remote Control: kako upravljati agenta s telefona

Markdown

Kako omogočiti Remote Control v namizni aplikaciji Google Antigravity in CLI-ju: stikalo, demon agy remote-control in kaj storiti ob težavah s povezavo.

Preberi celoten članek

Ailootova dokumentacija — referenčno gradivo o uporabi storitve.

Poudarki

V namizni aplikaciji Antigravity 2.0 omogočite Remote Control s stikalom v Settings → App. S sejo se lahko povežete na antigravity.google.com z istim računom Google. CLI Antigravity ima dva načina: /remote-control (ali zastavica --remote-control) odpre tunel za čas trajanja terminalske seje, medtem ko agy remote-control start zažene demon v ozadju brez odprtega terminala. V Linuxu demon deluje tudi po odjavi in se zažene po ponovnem zagonu; v Windowsu je za to potrebna namestitev, ki jo izvede skrbnik; v macOS in pri običajni namestitvi sistema Windows se znova zažene ob naslednji prijavi. Računalnik mora biti vklopljen in povezan z internetom. Funkcija morda ni na voljo zaradi pravil za račun ali organizacijo oziroma pogojev paketa.

Če Antigravityja še niste namestili, začnite s pregledom kaj je Google Antigravity in kako ga namestiti. Ta vodnik je namenjen primerom, ko agent že opravlja dolgotrajno nalogo (refaktoriranje, izvajanje testov, selitev odvisnosti), vi pa se morate oddaljiti od mize in želite še naprej upravljati sejo.

Kaj je Remote Control in zakaj ga potrebujete

Remote Control je funkcija Google Antigravity, ki vam omogoča varno povezovanje z namiznimi sejami in sejami CLI v vaših računalnikih ter njihovo upravljanje v katerem koli spletnem brskalniku. Kot je navedeno v uradnem opisu, lahko velike naloge — na primer refaktoriranje celotnega podsistema, dolgotrajno izvajanje testov ali zapletena selitev odvisnosti — trajajo dolgo. Remote Control vam omogoča upravljanje seje, ko niste ob računalniku, pri čemer celotno razvojno okolje ostane lokalno.

Funkcija deluje tako v namizni aplikaciji 2.0 kot v CLI-ju — terminalski različici Antigravityja (agy) — vendar se v vsakem načinu omogoči in deluje drugače.

Omogočanje Remote Control v namizni aplikaciji Antigravity 2.0

Remote Control lahko omogočite v nastavitvah aplikacije:

  1. Odprite podokno Settings z bližnjico Cmd + , (v Linuxu in Windowsu Ctrl + ,) ali kliknite gumb Settings na dnu levega podokna.
  2. Odprite razdelek App.
  3. Preklopite Enable Remote Control na On.
  4. (Izbirno) Nastavite Nickname, na primer workstation-primary ali server-machine, da boste ta računalnik zlahka prepoznali na seznamu povezanih naprav.

Povezovanje s telefona ali drugega brskalnika

Za odprtje oddaljene seje:

  1. V kateri koli napravi odprite brskalnik in obiščite nadzorno ploščo Antigravity Remote Control. V telefonu lahko spletno aplikacijo namestite tudi na začetni zaslon, da boste prejemali potisna obvestila, ko agent konča nalogo ali vas prosi za odgovor.
  2. Prijavite se z istim računom Google, ki ga uporabljate v namizni aplikaciji.
  3. V preklopniku naprav izberite želeni računalnik.
  4. Ko se povežete, lahko vidite aktivne pogovore; agentu lahko dodelite nove naloge ter si ogledate načrte izvedbe in artefakte.

Če se računalnik ne prikaže v spletnem vmesniku, uradna navodila priporočajo preverjanje treh stvari: stikalo Enable Remote Control je vklopljeno v računalniku, kjer se izvaja Antigravity; ta računalnik je povezan z internetom in ni prešel v stanje mirovanja; namizna aplikacija in brskalnik uporabljata isti račun Google.

Če se omrežna povezava v napravi, ki jo uporabljate za povezavo, začasno prekine, bo spletni vmesnik poskusil samodejno vzpostaviti povezavo znova. Opravila agenta v ozadju in ukazi, zagnani iz terminala, se v računalniku z Antigravityjem nemoteno izvajajo naprej, dokler je ta povezan z internetom.

Diagram: stikalo Remote Control na prenosniku prenese upravljanje na telefon, ko se prijavite z istim računom
Kako deluje Remote Control na namizju: vklopite stikalo v računalniku, nato se v telefonu prijavite z istim računom Google.

Dva načina Remote Control v CLI-ju Antigravity

CLI ima dva načina: interaktivni način, vezan na določen terminalski proces, in demon brez glave v ozadju, ki deluje brez odprtega terminala.

Interaktivni način: /remote-control

Remote Control lahko omogočite v trenutni interaktivni seji agy brez ponovnega zagona CLI-ja. Vnesite to v vrstico za vnos:

/remote-control

Kot je navedeno v uradnem opisu, CLI odpre povezavo — povratni tunel — za trenutno sejo in izpiše ime gostitelja ter povezavo do aktivnega pogovora, ki ga lahko nadaljujete v drugi napravi:

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.

Odprite to povezavo v brskalniku na prenosniku, tablici ali telefonu, prijavite se z istim računom Google, ki ga uporabljate v CLI-ju, in nadaljujte delo v seji prek spletnega vmesnika Antigravity.

Če želite izklopiti tunel, ne da bi končali lokalno terminalsko sejo:

/remote-control off

CLI lahko zaženete z že omogočenim Remote Control, tako da ob zagonu uporabite zastavico:

agy --remote-control

Interaktivni način je vezan na proces agy: ko zapustite CLI (/exit, Ctrl+C, Ctrl+D) ali zaprete terminalsko okno, se tunel Remote Control samodejno konča, vnos seje pa izgine z nadzorne plošče. Vsak interaktivni proces CLI ima svoj ID seje in ime gostitelja, zato lahko agy --remote-control hkrati zaženete v več zavihkih terminala ali delovnih imenikih.

Ko se z brskalnikom povežete z interaktivno sejo CLI, se obe strani sinhronizirata v realnem času. Zahteve iz oddaljene naprave prispejo neposredno v lokalni terminal, sklepanje agenta, klici orodij in spremembe kode pa so vidni v oddaljenem vmesniku. Če se agent ustavi in prosi za potrditev (y/n) ali zastavi dodatno vprašanje, lahko odgovorite s telefona ali lokalnega terminala. Nastavitve so izjema: v oddaljenem spletnem vmesniku jih ne morete spreminjati, temveč samo v samem CLI-ju.

Demon brez glave: agy remote-control start

Drugi način je trajni demon v ozadju, ki se registrira kot storitev operacijskega sistema. Na voljo je, dokler je računalnik vklopljen in povezan z internetom; delovanje po odjavi in ponovnem zagonu je odvisno od platforme.

agy remote-control start

Demon se registrira kot storitev operacijskega sistema (uporabniška storitev systemd v Linuxu, LaunchAgent v macOS ali Scheduled Task v Windowsu) in se takoj zažene brez odprtega terminalskega okna.

Z ukazom agy remote-control status si oglejte ime vnosa. Nato izberite ta računalnik na nadzorni plošči Antigravity Remote Control in nadaljujte delo prek spletnega vmesnika Antigravity.

Demon upravljate s tremi ukazi:

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

Demon uporablja poverilnice, s katerimi ste se prijavili v CLI. Prijava v CLI je ločena od prijave v namizni urejevalnik Antigravity na istem računalniku; v brskalniku uporabite isti račun Google kot v CLI-ju.

Ime računalnika za demon brez glave lahko ob zagonu nastavite z zastavico --name:

agy remote-control start --name "my-workstation"

Če znova zaženete start --name z novo vrednostjo, se ime računalnika spremeni.

Če imena ne nastavite, demon ob prvem zagonu ustvari ime, ki si ga je lahko zapomniti (na primer my-machine-distant-plume); trenutno ime prikaže ukaz agy remote-control status. Ime lahko spremenite tudi v nastavitveni datoteki: v Linuxu/macOS odprite ~/.gemini/config/config.json, v Windowsu pa %USERPROFILE%\.gemini\config\config.json, spremenite vrednost cliRemoteControlHostname, shranite datoteko in znova zaženite agy remote-control start, da se demon ponovno zažene. Novo ime se bo na nadzorni plošči prikazalo po ponovnem zagonu storitve; spremembe datoteke ne začnejo veljati, dokler demon deluje.

V datoteki sta dve podobni polji. cliRemoteControlHostname je ime demona CLI, ki ga opisujemo tukaj. remoteControlHostname je ločeno polje za namizni urejevalnik Antigravity na istem računalniku; v Antigravity 2.0 ga lahko spremenite v Settings → App.

Delovanje demona po odjavi in ponovnem zagonu

Delovanje je odvisno od operacijskega sistema:

DelovanjeLinuxmacOSWindows
ZagonOb zagonu sistema; prijava ni potrebnaOb prijaviOb zagonu sistema (če ga namesti skrbnik); sicer ob prijavi
Deluje po odjaviDaNe; znova se zažene ob naslednji prijaviDa, če je nastavljen za zagon ob zagonu sistema
Samodejno okrevanje po napakiDaDaDa, do treh poskusov ponovnega zagona, nato ob naslednjem zagonu sistema ali ob ponovnem zagonu ukaza agy remote-control start

Podrobnosti za Windows

Za registracijo demona za samodejni zagon ob zagonu sistema morate ukaz zagnati kot skrbnik. Uporabite lahko PowerShell ali običajni ukazni poziv. Ukaz start deluje tudi v običajnem oknu, vendar se bo demon po odjavi ali ponovnem zagonu znova zagnal šele ob naslednji prijavi, ne pa ob zagonu sistema. Ukaza status in stop delujeta v običajnem oknu brez povišanih pravic.

Kateri način izbrati

MeriloInteraktivni (/remote-control / agy --remote-control)Demon brez glave (agy remote-control start)
ObsegEna interaktivna terminalsko sejaCeloten računalnik (storitev operacijskega sistema v ozadju)
Življenjski cikelAktiven, dokler je Remote Control omogočen in terminalsko seja tečePreživi odjavo in ponovne zagone v Linuxu ter v Windowsu, če ga namesti skrbnik; v macOS in pri običajni namestitvi sistema Windows se znova zažene ob naslednji prijavi
Ime vnosaNovo za vsako sejo (na primer host-swift-falcon)Eno stalno ime računalnika (--name ali cliRemoteControlHostname)
SočasnostVeč terminalskih sej hkrati na enem računalnikuEna storitev demona na računalnik
Neposredna povezavaCLI izpiše povezavo do aktivnega pogovoraDostop prek preklopnika naprav na antigravity.google
Najprimernejši zaOddaljitev od aktivne terminalske naloge in nadaljevanje v telefonu ali brskalnikuStalen oddaljeni dostop do delovne postaje ali strežnika, dokler je računalnik vklopljen in povezan z internetom, ob upoštevanju pogojev za operacijski sistem

Interaktivni način zadostuje za upravljanje trenutne naloge s telefona. Če potrebujete oddaljeni dostop brez odprtega terminala, uporabite demon brez glave, ob upoštevanju pogojev za operacijski sistem.

Diagram: tunel seje izgine, ko zaprete terminal; demon v ozadju deluje brez odprtega terminala
Razlika med načinoma CLI: interaktivni tunel deluje samo, dokler je terminal odprt; demon brez glave deluje brez odprtega terminala (ob upoštevanju pogojev za operacijski sistem iz zgornje tabele).

Kaj storiti ob težavah s povezavo

Težave in rešitve iz uradne dokumentacije:

Kaj viditeZakajKaj storiti
Remote control is not enabled for your accountVaš račun ali pravilnik organizacije ne omogoča funkcije Remote ControlObrnite se na skrbnika delovnega prostora ali preverite, ali vaš paket podpira Remote Control
Vnos izgine z nadzorne plošče (CLI)/remote-control in agy --remote-control ustvarita tunela, ki se samodejno prekineta, ko zapustite interaktivno sejo (/exit, Ctrl+C) ali zaženete /remote-control offČe želite, da računalnik ostane na voljo brez odprtega terminala, namestite demon brez glave z ukazom agy remote-control start
Na nadzorni plošči se prikaže več vnosov CLI z istega računalnikaVsaka interaktivna seja CLI ima svoje ime gostitelja; to je običajno, kadar je odprtih več terminalovNičesar vam ni treba storiti; to je pričakovano delovanje
Računalnik se ne prikaže na nadzorni plošči (demon)Morda je prišlo do težave s prijavo v CLIZaženite agy remote-control status; če sporoči težavo s prijavo, zaženite agy, se znova prijavite in nato še enkrat zaženite agy remote-control start
Preimenovanje ni začelo veljatiDemon ime prebere ob zagonuZnova zaženite demon, tako da ponovno zaženete agy remote-control start
V Windowsu se demon zažene samo ob prijavi, ne pa ob zagonu sistemaUkaz start je bil zagnan brez skrbniških pravicZnova zaženite agy remote-control start v oknu s povišanimi pravicami
Povezava se nenehno prekinja in znova vzpostavljaMorda je še vedno registriran star demon, nameščen z namestitvenim skriptom, ki tekmuje z novim za povezavoZnova zaženite agy remote-control start; stara storitev se samodejno odstrani
Na nadzorni plošči se za en računalnik prikažeta dva podobna vnosaEden je za urejevalnik, drugi pa za demon CLI; namenoma sta ločenaPreimenujte tistega, ki ga želite razlikovati
Računalnik se ne prikaže na spletni nadzorni plošči (namizna aplikacija)Stikalo je morda izklopljeno, internetna povezava morda ni na voljo, računalnik je morda v stanju mirovanja ali pa se uporabljata različna računa GooglePreverite stikalo Enable Remote Control, internetno povezavo računalnika, ali je v stanju mirovanja, in ali je na obeh straneh uporabljen isti račun

Za podrobnejšo diagnostiko preverite dnevnike demona: v Linuxu zaženite journalctl --user -u antigravity-cli-daemon -n 50; v macOS si oglejte ~/Library/Logs/antigravity-cli-daemon.log; v Windowsu pa poiščite najnovejšo datoteko cli-*.log v %USERPROFILE%\.gemini\antigravity-cli\log.

Demon brez glave omogoča dostop brez odprtega terminala, tudi ko ste zdoma, ob upoštevanju pogojev delovanja računalnika in operacijskega sistema. Če stalnega dostopa ne potrebujete več, zaustavite demon z ukazom agy remote-control stop.

Oglejte si tudi ločen članek o oddaljenem upravljanju v Claude Code. Če želite drugega agenta upravljati prek Telegrama, preberite, kako nastaviti Hermes Agent v Telegramu.

Kaj sledi

Če delate v CLI-ju in se želite oddaljiti od trenutne naloge, začnite z interaktivnim načinom. Terminal pustite odprt: če ga zaprete, se tunel prekine, vnos seje pa izgine z nadzorne plošče. Za dostop do računalnika brez odprtega terminala uporabite demon, ob upoštevanju omejitev operacijskega sistema.

Več gradiva je na voljo na Ailootu.

Več podrobnosti

Vprašanja in odgovori: Google Antigravity Remote Control: kako upravljati agenta s telefona

Zakaj oddaljena seja izgine, ko zaprem terminal?

Interaktivni Remote Control pripada delujočemu procesu agy, zato izhod iz njega zapre tunel. Za dostop brez odprtega terminala uporabite demon brez vmesnika in preverite pogoje samodejnega zagona operacijskega sistema.

Kaj preverim, če računalnika ni na nadzorni plošči?

Preverite buden in povezan računalnik, vklop Remote Control ter isti Googlov račun v brskalniku in na namizju ali CLI. Pri seji demona z agy remote-control status preglejte težave prijave ali storitve.

Vsi članki