Perėjimas iš Gemini CLI į Antigravity CLI: vadovas

2026 m. gegužės 19 d. „Google“ paskelbė, kad birželio 18 d. išjungs senąjį Gemini CLI visiems Free, Pro ir Ultra planams. Praėjus dviem savaitėms nuo šio vadovo paskelbimo, komanda gemini nustos apdoroti užklausas. Perėjimas iš Gemini CLI į Antigravity CLI naudojant komandą agy yra vienintelis būdas likti prie „Google“ įrankių. agy parašyta Go kalba ir paleidžiama dešimtis kartų greičiau.

Jei ką nors naudojate su Gemini CLI — CI scenarijus, naktinius cron darbus, Gemini Code Assist IDE plėtinį — šiame vadove paaiškinama, kaip per vieną vakarą pereiti prie naujo įrankio nieko nesugadinant.

Kas tiksliai nustos veikti 2026 m. birželio 18 d.?#

Tai ne „visiškas projekto uždarymas“, o trijų populiariausių planų nutraukimas. Kam tai turės įtakos:

Iš oficialaus „Google Developers Blog“:

Jei naudojote Free planą, kaip dauguma pavienių kūrėjų, ir galvojate „bet juk turiu mokamą paskyrą“, tiksliai patikrinkite, kaip apmokestinamas jūsų API raktas. AI Pro nėra „Cloud“ apmokestinimas; tai asmeninė „Google AI“ prenumerata, kuri bus išjungta. „Cloud“ apmokestinimas per mokamą projektą nebus išjungtas.

Kodėl „Google“ apskritai uždaro Gemini CLI?#

Senasis gemini pasileisdavo per „šimtus milisekundžių“, nes Node.js reikėjo įšilti. Naujasis agy sukurtas kaip vienas statinis Go dvejetainis failas ir pasileidžia per „milisekundes“. CI ir scenarijuose, kurie per vieną vykdymą CLI iškviečia šimtus kartų, skirtumas yra reikšmingas.

Ką „Google“ sako apie greitį ir priežastį:

Visos pagrindinės Gemini CLI funkcijos perkeltos:

• Agent Skills — aplankas .gemini/skills/ dabar yra aplanke .agents/skills/.
• Hooks — tie patys įvykiai (PreToolUse, PostToolUse ir kt.); sintaksė beveik nepasikeitė.
• Subagentai — veikia kaip anksčiau, o jų konfigūracija perkeliama automatiškai.
• Plėtiniai — pervadinti Antigravity įskiepiais ir importuojami viena komanda.

Kas nebuvo sklandžiai perkelta: MCP serveriai ir seni scenarijai, tiesiogiai pasiekiantys .gemini/config.json. Pasak „GitHub“ diskusijos, kai kurie naudotojai praneša, kad MCP konfigūracijos nustoja veikti ir jas reikia perrašyti rankiniu būdu. Toliau tam skirta atskira dalis.

„Google“ neuždaro atvirojo kodo Gemini CLI projekto:

Tai reiškia, kad galite ją išsišakoti (fork) ir toliau naudoti su savo Gemini API raktu. Tačiau dabar tai mokama konfigūracija per „Cloud“ apmokestinimą; nemokamas Code Assist variantas baigiasi.

Kaip įdiegti Antigravity CLI: komandos, skirtos macOS, Linux ir Windows#

Prieš pradėdami greitai pasitikrinkite: kokį planą naudojate? Jei turite mokamą „Cloud“ projektą ir jūsų neveikia birželio 18 d. terminas, migracija pravers, bet nėra skubi. Jei naudojate Free/Pro/Ultra ir turite ką nors veikiančio su CLI, pereikite dabar, kol planai dar aktyvūs, kad galėtumėte palyginti veikimą atliekant tą pačią užduotį.

macOS ir Linux

Viena eilutė su curl:

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

Skriptas aptinka platformą, atsisiunčia agy dvejetainį failą, patikrina kontrolinę sumą ir įdeda jį į ~/.local/bin. Jei šio aplanko nėra PATH, įtraukite jį:

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

Patikrinkite, ar dvejetainis failas pasiekiamas:

which agy
agy --version

Windows (PowerShell)

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

Dvejetainis failas bus įdiegtas į C:\Users\[your_name]\AppData\Local\agy\bin. Diegimo programa automatiškai atnaujins PATH, tačiau atidarykite naują PowerShell langą, kad kintamieji būtų įkelti iš naujo.

Windows (CMD)

Jei įmonės politika blokuoja PowerShell:

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

Diegimo tikrinimas

Įdiegę bet kurioje OS, vykdykite:

agy doctor

Komanda patikrina dvejetainio failo versiją, ar yra konfigūracija, autentifikaciją ir tinklo prieigą prie antigravity.google. Jei nepavyksta pasiekti „Google“, problema susijusi su jūsų regionu arba tarpiniu serveriu.

Autentifikacija

Pirmą kartą paleidus agy be argumentų, atidaromas sąrankos vedlys:

1. Pasirinkite sąsajos temą.
2. Pasirinkite autentifikacijos metodą: Google OAuth (asmeninėms paskyroms) arba API raktą.
3. Jei norite, iškart importuokite konfigūraciją iš .gemini/.

Pasirinkus OAuth, atsidarys naršyklė ir nukreips jus į accounts.google.com; turėsite sutikti dalytis duomenimis. Tada CLI veiks.

Kaip perkelti konfigūraciją ir įskiepius iš .gemini į .agents#

Žingsnis po žingsnio:

1. agy plugin import gemini

   Vykdykite komandą iš bet kurio aplanko. Ji perkels globalius įskiepius iš ~/.gemini/ į ~/.agents/. Jei norite perkelti darbo srities įskiepius (esančius šalia projekto), vykdykite komandą projekto aplanke.

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

   Perkelkite skills rankiniu būdu pervadindami aplanką. Viduje esančių failų formatas toks pats, todėl Markdown perrašyti nereikia.

3. agy inspect

   Parodo, kurie įskiepiai, skills, hooks ir subagentai aktyvūs. Palyginkite su sąrašu, kurį turėjote Gemini CLI — nieko neturėtų trūkti.

4. agy config --edit

   Atidaro konfigūraciją numatytojoje rengyklėje ($EDITOR). Jei kas nors nebuvo perkelta automatiškai, redaguokite rankiniu būdu.

5. agy doctor

   Galutinė patikra: dvejetainis failas, autentifikacija, įskiepiai, tinklas. Jei visi keturi rodikliai žali, konfigūracijos perkėlimas baigtas.

Senąjį .gemini/ aplanką mėnesį palikčiau vietoje kaip atsarginę kopiją, jei kas nors būtų praleista. Savaitę naudoję Antigravity ir įsitikinę, kad viskas perkelta, galėsite jį ištrinti.

Jei naudojate AGENTS.md kaip universalią visų DI įrankių konfigūraciją, jo liesti nereikia. Antigravity CLI skaito AGENTS.md iš to paties aplanko kaip Claude Code arba Codex.

Kuriuos aplinkos kintamuosius reikia pakeisti?#

Visa keičiamų kintamųjų lentelė:

Jei „GitHub Actions“ perduoda secrets, atidarykite Settings -> Secrets -> Actions ir pervadinkite raktus. Pačios reikšmės nesikeičia („Google API“ raktas migracijos metu nepasikeitė).

Patikrinkite visas vietas, kuriose gali būti GEMINI_:

# Raskite paminėjimus visame projekte
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

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

Pakeitę kintamuosius, iš naujo paleiskite terminalą ir patikrinkite jų buvimą neišvesdami paslapties. Neįjunkite komandų sekimo ir nekopijuokite raktų reikšmių į žurnalus. Vien buvimas neįrodo autorizacijos; agy doctor patikrinkite atskirai:

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        # turėtų rodyti „authorized“

Kas dažniausiai sugenda pereinant ir kaip tai pataisyti#

Pradinių problemų kontrolinis sąrašas:

1. MCP serveriai. Jei naudojote mcp_servers faile .gemini/config.json, jie gali būti neperkelti paleidus agy plugin import gemini. Patikrinkite su agy inspect — bus MCP skiltis. Jei ji tuščia arba joje yra klaidų, perrašykite konfigūraciją rankiniu būdu su agy config --edit. Formatas aprašytas oficialioje Antigravity dokumentacijoje (ieškokite MCP skilties).

2. Pasirinktiniai hooks. Jei aplanke .gemini/hooks/ turėjote bash scenarijų, kuris skaitė $GEMINI_API_KEY, jis nebeveiks. Raskite tokias vietas: bash

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

   Pakeiskite kintamuosius.

3. CI/CD. „GitHub Actions“ arba „GitLab CI“ pakeiskite veiksmus, kurie naudoja komandą gemini, kad jie naudotų agy. Diegimo programoje dvejetainio failo pavadinimas gali skirtis, todėl sukurkite abstrakciją naudodami kintamąjį $CLI_CMD.

4. IDE plėtinys. Gemini Code Assist plėtinys, skirtas VS Code, bus išjungtas kartu su CLI. Jį pakeis Antigravity IDE (atskira VS Code atšaka) arba AGENTS.md bet kurioje kitoje DI rengyklėje.

5. @[file] įkėlimas. Pirmosiose Antigravity CLI versijose komanda @src/file.ts, skirta failui įkelti į kontekstą, turėjo klaidų. Atnaujinkite į naujausią versiją: agy update.

Jei kas nors kritiško sugenda ir to nepavyksta pataisyti per valandą, laikinas sprendimas Free planui — likti prie Gemini CLI iki birželio 18 d. ir migraciją rengti atskiroje saugyklos šakoje. Laiko limitas: 14 dienų.

Ar verta po birželio 18 d. likti prie „Google“ įrankių?#

Antigravity 2.0 galima laikyti atsarginiu pasirinkimu, kai pagrindinis įrankis (Claude Code arba Codex) netinka. Išsamiau apie jo privalumus ir trūkumus skaitykite Google Antigravity 2.0 vadove.

Trumpai, ką daryti atsižvelgiant į jūsų situaciją:

Migracijos kontrolinis sąrašas per 15 minučių#

1. Įdiekite Antigravity CLI

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

2. Paleiskite agy ir patvirtinkite tapatybę

   Be argumentų: agy. Pasirinkite OAuth arba API raktą.

3. Importuokite įskiepius iš .gemini

   agy plugin import gemini — ši komanda perkelia visuotinius plėtinius. Paleiskite ją dar kartą projekto aplanke, kad perkeltumėte darbo srities įskiepius.

4. Perkelkite skills

   mv .gemini/skills/ .agents/skills/. Failų turinys lieka toks pats.

5. Pakeiskite aplinkos kintamuosius

   Failuose ~/.zshrc/~/.bashrc ir .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Iš naujo paleiskite terminalą.

6. Patikrinkite diegimą

   agy doctor — visi keturi elementai (dvejetainis failas, autentifikacija, įskiepiai, tinklas) turi būti pažymėti žaliai.

7. Atlikite bandomąją užduotį

   agy "parašyk projekto README dabartiniame aplanke" — patikrinkite, ar rezultatas panašus į tą, kurį pateikė Gemini CLI.

8. Atnaujinkite „GitHub Actions“ / „GitLab CI“

   Pakeiskite komandos pavadinimą ir secrets iš GEMINI_* į AV_*.

9. Palikite .gemini/ kaip atsarginę kopiją

   Galite ją ištrinti praėjus 1–2 savaitėms po to, kai patvirtinsite, kad viskas veikia.

Ir galiausiai: birželio 18-oji nereiškia, kad „nustos veikti visi jūsų projektai“. Tai reiškia, kad išjungiamas nemokamas kanalas. Mokama Cloud API prieiga lieka, Gemini CLI saugykla lieka, o išsišakojimai (forks) galimi. Jei naudojote Free planą, turite apsispręsti iki birželio 18 d.; antraip kita komanda gemini "something" pateiks autorizacijos klaidą.