Selitev z Gemini CLI na Antigravity CLI: vodnik

Google je 19. maja 2026 napovedal, da bo 18. junija ukinil stari Gemini CLI za vse pakete Free, Pro in Ultra. Dva tedna po objavi tega vodnika bo ukaz gemini prenehal obdelovati zahteve. Selitev z Gemini CLI na Antigravity CLI z ukazom agy je edini način, da ostanete pri Googlovih orodjih. agy je napisan v jeziku Go in se zažene več desetkrat hitreje.

Če vam kar koli deluje z Gemini CLI — skripti CI, nočna opravila cron ali razširitev IDE Gemini Code Assist — ta vodnik pojasnjuje, kako se v enem večeru preseliti, ne da bi kaj pokvarili.

Kaj natančno bo 18. junija 2026 prenehalo delovati?#

To ni »popolna ukinitev projekta«, ampak prekinitev za tri najbolj priljubljene pakete. Koga bo to prizadelo:

Iz uradnega spletnega dnevnika Google Developers Blog:

Če ste uporabljali paket Free, tako kot večina posameznih razvijalcev, in razmišljate: »Ampak imam plačljiv račun« — natančno preverite, kako se zaračunava vaš ključ API. AI Pro ni obračunavanje prek Clouda; gre za osebno naročnino Google AI in bo onemogočena. Obračunavanje prek Clouda s plačljivim projektom ne bo onemogočeno.

Zakaj Google sploh ukinja Gemini CLI?#

Stari gemini se je zagnal v »stotinah milisekund«, ker se je moral Node.js najprej pripraviti na delo. Novi agy je izdelan kot ena statična binarna datoteka Go in se zažene v »milisekundah«. Pri CI in skriptih, ki CLI pokličejo več stokrat na izvajanje, je razlika znatna.

Kaj Google pravi o hitrosti in razlogu zanjo:

Vse ključne funkcije Gemini CLI so bile prenesene:

• Agent Skills — mapa .gemini/skills/ je zdaj v .agents/skills/.
• Hooks — dogodki so enaki (PreToolUse, PostToolUse itd.); sintaksa se je komaj kaj spremenila.
• Subagents — delujejo kot prej, njihova konfiguracija pa se preseli samodejno.
• Extensions — preimenovane so v vtičnike Antigravity in uvozite jih z enim ukazom.

Kaj se ni preselilo brez težav: strežniki MCP in stari skripti, ki neposredno dostopajo do .gemini/config.json. Po navedbah v razpravi na GitHubu nekateri uporabniki poročajo, da se konfiguracije MCP pokvarijo in jih je treba ročno prepisati. Temu je namenjen ločen spodnji razdelek.

Google ne zapira odprtokodnega projekta Gemini CLI:

To pomeni, da lahko ustvarite njegovo izpeljanko in ga še naprej uporabljate s svojim ključem Gemini API. Toda zdaj je to plačljiva namestitev z obračunavanjem prek Clouda; brezplačne možnosti Code Assist je konec.

Namestitev Antigravity CLI: ukazi za macOS, Linux in Windows#

Preden začnete, na hitro preverite: kateri paket uporabljate? Če imate plačljiv projekt Cloud in se vam 18. junija ne izteče rok, je selitev koristna, vendar ni nujna. Če uporabljate Free/Pro/Ultra in imate kaj, kar teče prek CLI-ja, preklopite zdaj, ko so paketi še aktivni, da boste lahko primerjali delovanje pri isti nalogi.

macOS in Linux

Enovrstični ukaz s curl:

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

Skript zazna platformo, prenese binarno datoteko agy, preveri njeno kontrolno vsoto in jo shrani v ~/.local/bin. Če ta mapa ni vključena v PATH, jo dodajte:

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

Preverite, ali je binarna datoteka na voljo:

which agy
agy --version

Windows (PowerShell)

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

Binarna datoteka bo nameščena v C:\Users\[your_name]\AppData\Local\agy\bin. Namestitveni program bo samodejno posodobil PATH, vendar odprite novo okno PowerShella, da znova naložite spremenljivke.

Windows (CMD)

Če vaša korporativna politika blokira PowerShell:

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

Preverjanje namestitve

Po namestitvi v katerem koli operacijskem sistemu zaženite:

agy doctor

Ukaz preveri različico binarne datoteke, ali obstaja konfiguracija, preverjanje pristnosti in omrežni dostop do antigravity.google. Če ne more vzpostaviti povezave z Googlom, je težava v vaši regiji ali posredniškem strežniku.

Preverjanje pristnosti

Ko prvič zaženete agy brez argumentov, se odpre čarovnik za nastavitev:

1. Izberite temo vmesnika.
2. Izberite način preverjanja pristnosti: Google OAuth (za osebne račune) ali ključ API.
3. Po želji takoj uvozite konfiguracijo iz .gemini/.

Če izberete OAuth, se odpre brskalnik in vas preusmeri na accounts.google.com; privoliti morate v deljenje podatkov. Nato CLI deluje.

Selitev konfiguracije in vtičnikov iz .gemini v .agents#

Korak za korakom:

1. agy plugin import gemini

   Ukaz zaženite iz katere koli mape. Globalne vtičnike bo preselil iz ~/.gemini/ v ~/.agents/. Za vtičnike delovnega prostora (ob projektu) ukaz zaženite iz projektne mape.

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

   Skills premaknite tako, da mapo ročno preimenujete. Oblika datotek v njej je enaka; vsebine Markdowna vam ni treba prepisovati.

3. agy inspect

   Prikaže aktivne vtičnike, skills, hooks in subagents. Primerjajte jih s seznamom, ki ste ga imeli v Gemini CLI — nič ne bi smelo manjkati.

4. agy config --edit

   Konfiguracijo odpre v privzetem urejevalniku ($EDITOR). Če česa ni samodejno prenesel, to uredite ročno.

5. agy doctor

   Končni pregled: binarna datoteka, preverjanje pristnosti, vtičniki, omrežje. Če so vsi štirje elementi označeni zeleno, je selitev konfiguracije končana.

Staro mapo .gemini/ pustite na mestu kot varnostno kopijo za en mesec, če bi kaj izpustili. Ko boste Antigravity uporabljali en teden in se prepričali, da je vse prisotno, jo lahko izbrišete.

Če uporabljate AGENTS.md kot univerzalno konfiguracijo za vsa orodja AI, vam ga ni treba spreminjati. Antigravity CLI bere AGENTS.md iz iste mape kot Claude Code ali Codex.

Katere okoljske spremenljivke je treba spremeniti?#

Celotna tabela zamenjav:

Če vaši GitHub Actions posredujejo skrivnosti, odprite Settings -> Secrets -> Actions in preimenujte ključe. Same vrednosti ostanejo enake (Googlov ključ API se med selitvijo ni spremenil).

Preverite vsa mesta, kjer bi se lahko pojavil GEMINI_:

# Poiščite omembe v celotnem projektu
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# V datotekah dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Po zamenjavi znova zaženite terminal in preverite prisotnost, ne da bi izpisali skrivnost. Ne omogočite sledenja lupine in vrednosti ključev ne kopirajte v dnevnike. Sama prisotnost ne dokazuje avtorizacije; agy doctor preverite ločeno:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # prikazati bi moral »authorized«

Kaj se med prehodom najpogosteje pokvari in kako to odpraviti#

Kontrolni seznam začetnih težav:

1. Strežniki MCP. Če ste uporabljali mcp_servers v .gemini/config.json, strežniki po zagonu agy plugin import gemini morda ne bodo zaznani. Preverite z agy inspect — prikazati bi se moral razdelek mcp. Če je prazen ali vsebuje napake, ga ročno prepišite z agy config --edit. Oblika je opisana v uradni dokumentaciji Antigravity (poiščite razdelek MCP).

2. Domači hooks. Če ste imeli skript bash v .gemini/hooks/, ki je bral $GEMINI_API_KEY, bo prenehal delovati. Poiščite taka mesta: bash

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

   Zamenjajte spremenljivke.

3. CI/CD. V GitHub Actions ali GitLab CI zamenjajte korake, ki uporabljajo ukaz gemini, z ukazom agy. Ime binarne datoteke v namestitvenem programu je lahko drugačno, zato ustvarite abstrakcijo s spremenljivko $CLI_CMD.

4. Razširitev IDE. Razširitev Gemini Code Assist za VS Code bo onemogočena skupaj s CLI-jem. Nadomestilo je Antigravity IDE (ločena izpeljanka VS Code) ali AGENTS.md v katerem koli drugem urejevalniku z orodji AI.

5. Nalaganje z @[file]. Zgodnje različice Antigravity CLI so imele napake pri ukazu @src/file.ts za nalaganje datoteke v kontekst. Posodobite na najnovejšo različico: agy update.

Če se kaj kritičnega pokvari in tega ni mogoče odpraviti v eni uri, je začasna rešitev za paket Free, da ostanete pri Gemini CLI do 18. junija, medtem ko pripravljate selitev na ločeni veji repozitorija. Časovna omejitev: 14 dni.

Se je po 18. juniju vredno še naprej držati Googlovih orodij?#

Antigravity 2.0 lahko upoštevate kot rezervno možnost, kadar vaše glavno orodje (Claude Code ali Codex) ni primerno. Za podrobnejši pregled njegovih prednosti in slabosti si oglejte vodnik za Google Antigravity 2.0.

Kratek pregled ukrepov glede na vaš položaj:

Kontrolni seznam za selitev v 15 minutah#

1. Namestite Antigravity CLI

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

2. Zaženite agy in se prijavite

   Brez argumentov: agy. Izberite OAuth ali ključ API.

3. Uvozite vtičnike iz .gemini

   agy plugin import gemini — s tem se vtičniki preselijo globalno. Zaženite ga znova v mapi projekta, da preselite vtičnike delovnega prostora.

4. Premaknite skills

   mv .gemini/skills/ .agents/skills/. Vsebina datotek ostane enaka.

5. Zamenjajte okoljske spremenljivke

   V datotekah ~/.zshrc/~/.bashrc in .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Znova zaženite terminal.

6. Preverite namestitev

   agy doctor — vsi štirje elementi (binarna datoteka, preverjanje pristnosti, vtičniki, omrežje) morajo biti označeni zeleno.

7. Zaženite preizkusno nalogo

   agy "write a README for the project in the current folder" — preverite, ali je rezultat podoben tistemu, ki ga je ustvaril Gemini CLI.

8. Posodobite GitHub Actions / GitLab CI

   Spremenite ime ukaza in skrivnosti iz GEMINI_* v AV_*.

9. Ohranite .gemini/ kot varnostno kopijo

   Izbrišete jo lahko 1–2 tedna po potrditvi, da vse deluje.

In še nazadnje: 18. junij ne pomeni, da bodo »vsi vaši projekti prenehali delovati«. Pomeni, da bo brezplačni kanal onemogočen. Plačljivi dostop do Cloud API ostane na voljo, repozitorij Gemini CLI ostane na voljo, izpeljanke pa so še vedno mogoče. Če ste uporabljali paket Free, se morate odločiti pred 18. junijem; sicer bo naslednji ukaz gemini "something" vrnil napako preverjanja pristnosti.