Siirtyminen Gemini CLI:stä Antigravity CLI:hin: opas

Google ilmoitti 19. toukokuuta 2026 sulkevansa vanhan Gemini CLI:n kaikilta Free-, Pro- ja Ultra-tilaustasoilta 18. kesäkuuta. Kaksi viikkoa tämän oppaan julkaisun jälkeen gemini-komento lakkaa käsittelemästä pyyntöjä. Siirtyminen Gemini CLI:stä Antigravity CLI:hin agy-komennolla on ainoa tapa jatkaa Googlen työkalujen käyttöä. agy on rakennettu Go-kielellä, ja se käynnistyy kymmeniä kertoja nopeammin.

Jos sinulla on Gemini CLI:llä käynnissä jotakin – CI-skriptejä, öisiä cron-töitä tai Gemini Code Assist -IDE-laajennus – tässä oppaassa kerrotaan, miten voit siirtyä uuteen järjestelmään yhdessä illassa rikkomatta mitään.

Mikä tarkalleen lakkaa toimimasta 18. kesäkuuta 2026?#

Kyse ei ole ”projektin täydellisestä sulkemisesta”, vaan kolmen suosituimman tilaustason lopettamisesta. Keitä tämä koskee:

Virallisesta Google Developers Blogista:

Jos käytit Free-tasoa, kuten useimmat yksittäiset kehittäjät, ja ajattelet ”mutta minulla on maksullinen tili”, tarkista, miten API-avaimesi laskutetaan. AI Pro ei ole Cloud-laskutusta; se on henkilökohtainen Google AI -tilaus, ja se poistetaan käytöstä. Maksulliseen projektiin perustuva Cloud-laskutus ei poistu käytöstä.

Miksi Google ylipäätään sulkee Gemini CLI:n?#

Vanha gemini käynnistyi ”sadoissa millisekunneissa”, koska Node.js:n piti lämmetä. Uusi agy on toteutettu yhtenä staattisena Go-binääritiedostona, ja se käynnistyy ”millisekunneissa”. Ero on merkittävä CI:ssä ja skripteissä, jotka kutsuvat CLI:tä satoja kertoja yhdellä suorituskerralla.

Näin Google kuvailee nopeutta ja syytä:

Kaikki Gemini CLI:n tärkeimmät ominaisuudet ovat siirtyneet uuteen järjestelmään:

• Agent Skills — .gemini/skills/-kansio sijaitsee nyt polussa .agents/skills/.
• Hooks — samat tapahtumat (PreToolUse, PostToolUse jne.); syntaksi ei ole juuri muuttunut.
• Subagents — toimivat kuten ennenkin, ja niiden asetukset siirretään automaattisesti.
• Extensions — nimetty uudelleen Antigravity-lisäosiksi, jotka tuodaan yhdellä komennolla.

Saumattomasti eivät siirtyneet MCP-palvelimet eivätkä vanhat skriptit, jotka käyttävät suoraan tiedostoa .gemini/config.json. GitHub-keskustelun mukaan jotkut käyttäjät kertovat, että MCP-asetukset rikkoutuvat ja ne täytyy kirjoittaa uudelleen käsin. Tätä käsitellään erillisessä osiossa alempana.

Google ei sulje avoimen lähdekoodin Gemini CLI -projektia:

Voit siis forkata sen ja jatkaa käyttöä omalla Gemini API -avaimellasi. Käyttö on kuitenkin nyt maksullista Cloud-laskutuksen kautta; maksuton Code Assist -järjestely päättyy.

Antigravity CLI:n asentaminen: komennot macOS:lle, Linuxille ja Windowsille#

Tee ennen aloittamista nopea itsearviointi: mikä tilaustaso sinulla on? Jos käytössäsi on maksullinen Cloud-projekti eikä sinulla ole kesäkuun 18. päivän määräaikaa, siirtymisestä on hyötyä, mutta se ei ole kiireellistä. Jos käytössäsi on Free/Pro/Ultra ja jokin suoritetaan CLI:n kautta, vaihda nyt tilausten ollessa vielä aktiivisia, jotta voit vertailla toimintaa samalla tehtävällä.

macOS ja Linux

Yhden rivin komento curl-komennolla:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Skripti tunnistaa alustan, lataa agy-binääritiedoston, tarkistaa sen tarkistussumman ja sijoittaa sen polkuun ~/.local/bin. Jos kansio ei ole PATH-muuttujassa, lisää se:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Tarkista, että binääritiedosto löytyy:

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

Binääritiedosto asennetaan polkuun C:\Users\[your_name]\AppData\Local\agy\bin. Asennusohjelma päivittää PATH-muuttujan automaattisesti, mutta avaa uusi PowerShell-ikkuna, jotta muuttujat latautuvat uudelleen.

Windows (CMD)

Jos yrityksesi käytäntö estää PowerShellin käytön:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Asennuksen tarkistaminen

Suorita asennuksen jälkeen missä tahansa käyttöjärjestelmässä:

agy doctor

Komento tarkistaa binäärin version, määritystiedoston olemassaolon, todennuksen ja verkkoyhteyden osoitteeseen antigravity.google. Jos yhteys Googleen ei onnistu, ongelma johtuu alueestasi tai välityspalvelimesta.

Todennus

Kun suoritat agy-komennon ensimmäisen kerran ilman argumentteja, käynnistyy ohjattu määritys:

1. Valitse käyttöliittymän teema.
2. Valitse todennustapa: Google OAuth (henkilökohtaisille tileille) tai API-avain.
3. Voit halutessasi tuoda määritykset .gemini/-kansiosta heti.

Jos valitset OAuthin, selain avautuu ja uudelleenohjaa osoitteeseen accounts.google.com; sinun täytyy antaa suostumus tietojen jakamiseen. Sen jälkeen CLI toimii.

Määritysten ja lisäosien siirtäminen .gemini-kansiosta .agents-kansioon#

Vaihe vaiheelta:

1. agy plugin import gemini

   Suorita komento mistä tahansa kansiosta. Se siirtää yleiset lisäosat kansiosta ~/.gemini/ kansioon ~/.agents/. Siirrä projektikohtaiset lisäosat suorittamalla komento projektikansiossa.

2. mv .gemini/skills/ .agents/skills/

   Siirrä skills vaihtamalla kansion nimi käsin. Tiedostomuoto on sama, joten markdown-tiedostoja ei tarvitse kirjoittaa uudelleen.

3. agy inspect

   Näyttää aktiiviset lisäosat, skills-kokonaisuudet, hooks-käsittelijät ja subagents-agentit. Vertaa luetteloa Gemini CLI:n luetteloon – mitään ei pitäisi puuttua.

4. agy config --edit

   Avaa määritykset oletuseditorissa ($EDITOR). Muokkaa käsin kaikkea, mikä ei siirtynyt automaattisesti.

5. agy doctor

   Viimeinen tarkistus: binääri, todennus, lisäosat, verkko. Jos kaikki neljä ovat kunnossa, määritysten siirto on valmis.

Jättäisin vanhan .gemini/-kansion varmuuskopioksi kuukaudeksi siltä varalta, että jotakin jäi huomaamatta. Kun olet käyttänyt Antigravitya viikon ja varmistanut, että kaikki on tallella, voit poistaa sen.

Jos käytät AGENTS.md:tä kaikkien tekoälytyökalujen yleisenä määritystiedostona, sinun ei tarvitse muuttaa sitä. Antigravity CLI lukee AGENTS.md:n samasta kansiosta kuin Claude Code tai Codex.

Mitkä ympäristömuuttujat täytyy vaihtaa?#

Täydellinen korvaustaulukko:

Jos GitHub Actions -työnkuluissa välitetään salaisuuksia, avaa Settings -> Secrets -> Actions ja vaihda avainten nimet. Arvot pysyvät samoina (Googlen API-avain ei muuttunut siirtymän aikana).

Tarkista kaikki paikat, joissa voi olla GEMINI_:

# Etsi maininnat koko projektista
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# Dotfiles-tiedostoista
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Käynnistä pääte uudelleen muuttujien vaihtamisen jälkeen ja tarkista olemassaolo tulostamatta salaisuutta. Älä ota komentotulkin jäljitystä käyttöön tai kopioi avainarvoja lokeihin. Olemassaolo ei yksin todista valtuutusta; tarkista agy doctor erikseen:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY on asetettu\n'
else
    printf 'AV_API_KEY puuttuu tai on tyhjä\n'
fi
agy doctor        # should show “authorized”

Mikä siirtymässä yleensä rikkoutuu ja miten sen voi korjata?#

Luettelo alkuvaiheen ongelmista:

1. MCP-palvelimet. Jos käytit mcp_servers-asetusta tiedostossa .gemini/config.json, palvelimet eivät ehkä siirry komennolla agy plugin import gemini. Tarkista tilanne komennolla agy inspect – tulosteessa on mcp-osio. Jos se on tyhjä tai sisältää virheitä, kirjoita määritykset uudelleen käsin komennolla agy config --edit. Muoto on kuvattu Antigravityn virallisessa dokumentaatiossa (etsi MCP-osio).

2. Mukautetut hooks-käsittelijät. Jos sinulla oli bash-skripti kansiossa .gemini/hooks/, joka luki $GEMINI_API_KEY-muuttujan, se lakkaa toimimasta. Etsi tällaiset kohdat: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Vaihda muuttujat.

3. CI/CD. Vaihda GitHub Actionsissa tai GitLab CI:ssä komennon gemini käyttö komennoksi agy. Asennusohjelman binääritiedoston nimi voi vaihdella, joten luo abstraktio $CLI_CMD-muuttujan avulla.

4. IDE-laajennus. Gemini Code Assist -laajennus VS Codeen poistetaan käytöstä CLI:n kanssa. Sen korvaa Antigravity IDE (erillinen VS Code -forkki) tai AGENTS.md missä tahansa muussa tekoälyeditorissa.

5. @[file]-lataus. Antigravity CLI:n varhaisissa koontiversioissa komennossa @src/file.ts, jolla tiedosto ladataan kontekstiin, oli virheitä. Päivitä uusimpaan versioon: agy update.

Jos jokin kriittinen toiminto rikkoutuu eikä sitä saada korjattua tunnissa, Free-tason väliaikaisena ratkaisuna voi jatkaa Gemini CLI:n käyttöä 18. kesäkuuta asti ja valmistella siirtymää erillisessä repositoryn haarassa. Aikaraja: 14 päivää.

Kannattaako Googlen työkalujen käyttöä jatkaa 18. kesäkuuta jälkeen?#

Antigravity 2.0:aa voi pitää varavaihtoehtona tilanteisiin, joissa ensisijainen työkalusi (Claude Code tai Codex) ei sovi tehtävään. Lue Google Antigravity 2.0 -opas, jossa kerrotaan tarkemmin sen vahvuuksista ja heikkouksista.

Lyhyt yhteenveto siitä, mitä eri tilanteissa kannattaa tehdä:

Siirtymisen tarkistuslista 15 minuutissa#

1. Asenna Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) tai irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. Käynnistä agy ja todenna käyttäjäsi

   Ilman argumentteja: agy. Valitse OAuth tai API-avain.

3. Tuo lisäosat .gemini-kansiosta

   agy plugin import gemini—tämä siirtää lisäosat yleiseen käyttöön. Suorita komento uudelleen projektikansiossa, jos haluat siirtää projektikohtaiset lisäosat.

4. Siirrä skills

   mv .gemini/skills/ .agents/skills/. Tiedostojen sisältö pysyy ennallaan.

5. Korvaa ympäristömuuttujat

   Tiedostoissa ~/.zshrc/~/.bashrc ja .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Käynnistä pääte uudelleen.

6. Tarkista asennus

   agy doctor – kaikkien neljän kohdan (binääri, todennus, lisäosat, verkko) pitäisi olla kunnossa.

7. Suorita testitehtävä

   agy "write a README for the project in the current folder" – tarkista, että tulos vastaa Gemini CLI:n tuottamaa tulosta.

8. Päivitä GitHub Actions / GitLab CI

   Vaihda komennon nimi ja secrets-muuttujat GEMINI_*-muodosta AV_*-muotoon.

9. Säilytä .gemini/ varmuuskopiona

   Voit poistaa kansion 1–2 viikkoa sen jälkeen, kun olet varmistanut kaiken toimivan.

Lopuksi: 18. kesäkuuta ei tarkoita, että ”kaikki projektisi lakkaavat toimimasta”. Se tarkoittaa, että maksuton kanava poistetaan käytöstä. Maksullinen Cloud API -käyttö säilyy, Gemini CLI -repository säilyy ja forkkaaminen on mahdollista. Jos käytit Free-tasoa, sinun on tehtävä päätös ennen 18. kesäkuuta; muuten seuraava gemini "something" palauttaa todennusvirheen.