Google Antigravity Remote Control: agentin hallinta puhelimella

Jos et ole vielä asentanut Antigravitya, aloita tutustumalla siihen, mikä Google Antigravity on ja miten se asennetaan. Tämä opas on tarkoitettu tilanteisiin, joissa agentti käsittelee jo pitkää tehtävää (refaktorointia, testien suorittamista tai riippuvuuksien siirtoa) ja sinun on poistuttava työpöytäsi äärestä mutta säilytettävä istunnon hallinta.

Mikä Remote Control on ja miksi tarvitset sitä#

Remote Control on Google Antigravityn ominaisuus, jonka avulla voit muodostaa turvallisen yhteyden tietokoneidesi työpöytä- ja CLI-istuntoihin ja hallita niitä millä tahansa verkkoselaimella. Virallisen kuvauksen mukaan suuret tehtävät – esimerkiksi koko alijärjestelmän refaktorointi, pitkä testiajo tai monimutkainen riippuvuuksien siirto – voivat kestää pitkään. Remote Controlin avulla voit hallita istuntoa poissa tietokoneeltasi ja pitää koko kehitysympäristösi paikallisena.

Ominaisuus toimii sekä Antigravity 2.0 -työpöytäsovelluksessa että CLI:ssä eli Antigravityn pääteversiossa (agy), mutta käyttöönotto ja toiminta eroavat niissä toisistaan.

Remote Controlin käyttöönotto Antigravity 2.0 -työpöytäsovelluksessa#

Voit ottaa Remote Controlin käyttöön sovelluksen asetuksissa:

1. Avaa Settings-paneeli näppäinyhdistelmällä Cmd + , (tai Ctrl + , Linuxissa ja Windowsissa) tai napsauta vasemman paneelin alareunassa olevaa Settings-painiketta.
2. Siirry App-osioon.
3. Aseta Enable Remote Control -valitsin tilaan On.
4. (Valinnainen) Määritä Nickname, esimerkiksi workstation-primary tai server-machine, jotta tunnistat tämän tietokoneen helposti yhdistettyjen laitteiden luettelosta.

Yhteyden muodostaminen puhelimesta tai toisesta selaimesta

Avaa etäistunto näin:

1. Avaa selain millä tahansa laitteella ja siirry Antigravity Remote Control Dashboardiin. Puhelimella voit myös asentaa verkkosovelluksen aloitusnäyttöön, jolloin saat push-ilmoituksen, kun agentti saa tehtävän valmiiksi tai pyytää vastaustasi.
2. Kirjaudu sisään samalla Google-tilillä, jota käytät tietokoneella.
3. Valitse haluamasi tietokone laitteenvalitsimesta.
4. Kun yhteys on muodostettu, näet aktiiviset keskustelut. Voit aloittaa agentille uusia tehtäviä ja tarkastella toteutussuunnitelmia ja artefakteja.

Jos tietokone ei näy verkkokäyttöliittymässä, virallisten ohjeiden mukaan tarkista kolme asiaa: Enable Remote Control -valitsin on käytössä tietokoneessa, jossa Antigravity on käynnissä; tietokoneella on internetyhteys eikä se ole mennyt lepotilaan; ja työpöytäsovelluksessa ja selaimessa käytetään samaa Google-tiliä.

Jos käyttämäsi laitteen verkkoyhteys katkeaa tilapäisesti, verkkokäyttöliittymä yrittää muodostaa yhteyden uudelleen automaattisesti. Antigravitya käyttävän tietokoneen taustatehtävät ja päätteestä käynnistetyt komennot jatkavat toimintaansa keskeytyksettä, kunhan tietokone pysyy yhteydessä internetiin.

Antigravity CLI:n kaksi Remote Control -tilaa#

CLI:ssä on kaksi tilaa: tiettyyn pääteprosessiin sidottu vuorovaikutteinen tila sekä headless-taustapalvelu, joka toimii ilman avointa päätettä.

Vuorovaikutteinen tila: /remote-control

Voit ottaa Remote Controlin käyttöön nykyisessä vuorovaikutteisessa agy-istunnossa käynnistämättä CLI:tä uudelleen. Suorita tämä syöterivillä:

/remote-control

Virallisen kuvauksen mukaan CLI avaa nykyiselle istunnolle yhteyden eli käänteisen tunnelin ja näyttää isäntänimen sekä aktiiviseen keskusteluun vievän linkin, jonka voi avata toisella laitteella:

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.

Avaa linkki kannettavan tietokoneen, tabletin tai puhelimen selaimessa, kirjaudu sisään samalla Google-tilillä, jota käytät CLI:ssä, ja jatka istunnon käyttöä Antigravity-verkkokäyttöliittymän kautta.

Poista tunneli käytöstä päättämättä paikallista pääteistuntoa näin:

/remote-control off

Voit käynnistää CLI:n niin, että Remote Control on jo käytössä, käyttämällä käynnistysvalitsinta:

agy --remote-control

Vuorovaikutteinen tila on sidottu agy-prosessiin: kun poistut CLI:stä (/exit, Ctrl+C, Ctrl+D) tai suljet pääteikkunan, Remote Control -tunneli päättyy automaattisesti ja istuntomerkintä katoaa hallintapaneelista. Jokaisella vuorovaikutteisella CLI-prosessilla on oma istuntotunnuksensa ja isäntänimensä, joten voit suorittaa agy --remote-control -komentoa samanaikaisesti useissa päätevälilehdissä tai työhakemistoissa.

Kun muodostat selaimella yhteyden vuorovaikutteiseen CLI-istuntoon, molemmat osapuolet synkronoituvat reaaliajassa. Etälaitteelta tulevat pyynnöt siirtyvät suoraan paikalliseen päätteeseen, ja agentin päättely, työkalukutsut ja koodimuutokset näkyvät etäkäyttöliittymässä. Jos agentti pysähtyy pyytämään vahvistusta (y/n) tai esittää jatkokysymyksen, voit vastata puhelimella tai paikallisessa päätteessä. Asetukset ovat poikkeus: niitä ei voi muuttaa etäverkkokäyttöliittymässä, vaan ainoastaan CLI:ssä.

Headless-taustapalvelu: agy remote-control start

Toinen tila on pysyvä taustapalvelu, joka rekisteröidään käyttöjärjestelmän palveluksi. Se on käytettävissä, kun tietokone on päällä ja yhteydessä internetiin; toiminta uloskirjautumisen ja uudelleenkäynnistyksen jälkeen riippuu alustasta.

agy remote-control start

Taustapalvelu rekisteröidään käyttöjärjestelmän palveluksi (Linuxissa systemd-käyttäjäpalveluna, macOS:ssä LaunchAgent-käynnistysagenttina tai Windowsissa ajoitettuna tehtävänä) ja käynnistyy heti ilman avointa pääteikkunaa.

Näet merkinnän nimen komennolla agy remote-control status. Valitse sitten tämä tietokone Antigravity Remote Control Dashboardissa ja jatka työskentelyä Antigravity-verkkokäyttöliittymän kautta.

Taustapalvelua hallitaan kolmella komennolla:

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

Taustapalvelu käyttää tunnistetietoja, joilla kirjauduit CLI:hin. CLI:hin kirjautuminen on eri asia kuin samalla tietokoneella olevaan Antigravity-työpöytäeditoriin kirjautuminen. Käytä selaimessa samaa Google-tiliä kuin CLI:ssä.

Voit määrittää headless-taustapalvelun tietokoneen nimen käynnistysvaiheessa --name-valitsimella:

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

Jos suoritat start --name -komennon uudelleen uudella arvolla, tietokone nimetään uudelleen.

Jos et määritä nimeä, taustapalvelu luo ensimmäisellä käynnistyskerralla mieleenpainuvan nimen (kuten my-machine-distant-plume); agy remote-control status näyttää nykyisen nimen. Voit myös nimetä tietokoneen uudelleen asetustiedostossa: avaa Linuxissa/macOS:ssä ~/.gemini/config/config.json tai Windowsissa %USERPROFILE%\.gemini\config\config.json, muuta arvon cliRemoteControlHostname sisältö, tallenna tiedosto ja käynnistä taustapalvelu uudelleen suorittamalla agy remote-control start. Uusi nimi näkyy hallintapaneelissa palvelun uudelleenkäynnistyksen jälkeen. Tiedostoon tehdyt muutokset eivät tule voimaan taustapalvelun ollessa käynnissä.

Tiedostossa on kaksi samankaltaista kenttää. cliRemoteControlHostname on tässä käytettävän CLI-taustapalvelun nimi. remoteControlHostname on erillinen kenttä samalla tietokoneella olevalle Antigravity-työpöytäeditorille. Antigravity 2.0:ssa voit muuttaa sitä kohdassa Settings → App.

Taustapalvelun toiminta uloskirjautumisen ja uudelleenkäynnistyksen jälkeen

Toiminta riippuu käyttöjärjestelmästä:

Windows-kohtaiset tiedot

Taustapalvelun rekisteröiminen käynnistymään automaattisesti järjestelmän käynnistyessä edellyttää järjestelmänvalvojan oikeuksia. Voit käyttää joko PowerShellia tai tavallista komentokehotetta. start-komento toimii myös tavallisessa ikkunassa, mutta uloskirjautumisen tai uudelleenkäynnistyksen jälkeen taustapalvelu jatkaa toimintaansa vasta seuraavan kirjautumisen yhteydessä, ei tietokoneen käynnistyessä. status- ja stop-komennot toimivat tavallisessa ikkunassa ilman korotettuja oikeuksia.

Kumman tilan valitsen?

Vuorovaikutteinen tila riittää käynnissä olevan tehtävän hallintaan puhelimella. Jos tarvitset etäyhteyden ilman avointa päätettä, käytä headless-taustapalvelua käyttöjärjestelmäsi ehtojen mukaisesti.

Mitä tehdä yhteysongelmissa#

Virallisen dokumentaation ongelmat ja ratkaisut:

Jos tarvitset tarkempaa diagnostiikkaa, tarkista taustapalvelun lokit: suorita Linuxissa journalctl --user -u antigravity-cli-daemon -n 50; tarkista macOS:ssä ~/Library/Logs/antigravity-cli-daemon.log; Windowsissa tarkista uusin cli-*.log hakemistossa %USERPROFILE%\.gemini\antigravity-cli\log.

Headless-taustapalvelu mahdollistaa käytön ilman avointa päätettä myös silloin, kun olet poissa, tietokoneen ja käyttöjärjestelmän toimintaehdot huomioiden. Jos et enää tarvitse pysyvää käyttöoikeutta, pysäytä taustapalvelu komennolla agy remote-control stop.

Aiheesta on erillinen artikkeli: etähallinta Claude Codessa. Jos haluat hallita toista agenttia Telegramin kautta, katso Hermes Agentin käyttöönotto Telegramissa.

Mitä seuraavaksi?#

Jos työskentelet CLI:ssä ja haluat poistua nykyisen tehtävän ääreltä, aloita vuorovaikutteisesta tilasta. Jätä pääte auki: jos suljet sen, tunneli katkeaa ja istuntomerkintä katoaa hallintapaneelista. Jos haluat käyttää tietokonetta ilman avointa päätettä, käytä taustapalvelua käyttöjärjestelmäsi rajoitusten mukaisesti.

Lisää materiaalia on saatavilla Ailootissa.