Migrácia z Gemini CLI na Antigravity CLI: Sprievodca

Google 19. mája 2026 oznámil, že 18. júna ukončí fungovanie starého Gemini CLI pre všetky programy Free, Pro a Ultra. Dva týždne po zverejnení tohto sprievodcu prestane príkaz gemini spracúvať požiadavky. Migrácia z Gemini CLI na Antigravity CLI pomocou príkazu agy je jediný spôsob, ako zostať pri nástrojoch Google. agy je napísaný v jazyku Go a spúšťa sa desaťkrát rýchlejšie.

Ak máte niečo spustené cez Gemini CLI — skripty CI, nočné úlohy cron alebo rozšírenie Gemini Code Assist pre IDE — tento sprievodca vysvetľuje, ako migráciu zvládnuť za jeden večer bez toho, aby ste niečo pokazili.

Čo presne prestane fungovať 18. júna 2026?#

Nejde o „úplné ukončenie projektu“, ale o odstavenie troch najpopulárnejších programov. Koho sa to týka:

Z oficiálneho blogu Google Developers Blog:

Ak ste používali program Free, podobne ako väčšina individuálnych vývojárov, a hovoríte si „veď mám platený účet“, presne si overte, ako sa účtuje vaše API kľúč. AI Pro nie je účtovanie cez Cloud; je to osobné predplatné Google AI a bude vypnuté. Cloud účtovanie s plateným projektom vypnuté nebude.

Prečo Google vôbec ukončuje Gemini CLI?#

Starý gemini sa spúšťal „stovky milisekúnd“, pretože Node.js sa musel zahriať. Nový agy je zostavený ako jediný statický binárny súbor Go a spúšťa sa „za milisekundy“. Pri CI a skriptoch, ktoré počas jedného behu volajú CLI stokrát, je rozdiel výrazný.

Čo Google hovorí o rýchlosti a dôvode:

Všetky kľúčové funkcie Gemini CLI boli prenesené:

• Agent Skills — priečinok .gemini/skills/ sa teraz nachádza v .agents/skills/.
• Háčiky — rovnaké udalosti (PreToolUse, PostToolUse atď.); syntax sa zmenila len veľmi málo.
• Podriadení agenti — fungujú ako predtým a ich konfigurácia sa migruje automaticky.
• Rozšírenia — premenovali sa na doplnky Antigravity a importujú sa jedným príkazom.

Čo sa neprenieslo bez problémov: servery MCP a staré skripty, ktoré pristupujú priamo k .gemini/config.json. Podľa diskusie na GitHube niektorí používatelia uvádzajú, že konfigurácie MCP prestanú fungovať a treba ich prepísať ručne. Nižšie je tomu venovaná samostatná časť.

Google neukončuje open source projekt Gemini CLI:

To znamená, že si ho môžete forknúť a pokračovať v používaní s vlastným kľúčom Gemini API. Teraz však ide o platené nastavenie cez Cloud účtovanie; bezplatná možnosť Code Assist sa končí.

Ako nainštalovať Antigravity CLI: príkazy pre macOS, Linux a Windows#

Pred začiatkom si rýchlo overte: aký program používate? Ak máte platený Cloud projekt bez termínu 18. júna, migrácia sa hodí, ale nie je naliehavá. Ak používate Free/Pro/Ultra a máte niečo spustené cez CLI, prejdite naň teraz, kým sú programy stále aktívne, aby ste mohli porovnať správanie pri rovnakej úlohe.

macOS a Linux

Jeden príkaz s curl:

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

Skript rozpozná platformu, stiahne binárny súbor agy, skontroluje jeho kontrolný súčet a uloží ho do ~/.local/bin. Ak tento priečinok nie je v PATH, pridajte ho:

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

Skontrolujte, či je binárny súbor dostupný:

which agy
agy --version

Windows (PowerShell)

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

Binárny súbor sa nainštaluje do C:\Users\[your_name]\AppData\Local\agy\bin. Inštalátor automaticky aktualizuje PATH, ale otvorte nové okno PowerShell, aby sa premenné znova načítali.

Windows (CMD)

Ak firemné pravidlá blokujú PowerShell:

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

Overenie inštalácie

Po inštalácii na ľubovoľnom OS spustite:

agy doctor

Príkaz skontroluje verziu binárneho súboru, či existuje konfigurácia, overenie totožnosti a sieťový prístup k antigravity.google. Ak sa nedokáže pripojiť ku Googlu, problém súvisí s vaším regiónom alebo proxy serverom.

Overenie totožnosti

Pri prvom spustení agy bez argumentov sa otvorí sprievodca nastavením:

1. Vyberte motív rozhrania.
2. Vyberte spôsob overenia totožnosti: Google OAuth (pre osobné účty) alebo kľúč API.
3. Voliteľne môžete hneď importovať konfiguráciu z .gemini/.

Ak vyberiete OAuth, otvorí sa prehliadač a presmeruje vás na accounts.google.com; budete musieť udeliť súhlas so zdieľaním údajov. Potom bude CLI fungovať.

Ako migrovať konfiguráciu a doplnky z .gemini do .agents#

Postup krok za krokom:

1. agy plugin import gemini

   Príkaz spustite z ľubovoľného priečinka. Premigruje globálne doplnky z ~/.gemini/ do ~/.agents/. Ak chcete migrovať doplnky pracovného priestoru (vedľa projektu), spustite príkaz v priečinku projektu.

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

   Skills presuňte ručným premenovaním priečinka. Formát súborov v ňom je rovnaký; Markdown netreba prepisovať.

3. agy inspect

   Zobrazuje aktívne doplnky, skills, háčiky a podriadených agentov. Porovnajte ich so zoznamom v Gemini CLI — nič by nemalo chýbať.

4. agy config --edit

   Otvorí konfiguráciu v predvolenom editore ($EDITOR). Ak sa niečo neprevzalo automaticky, upravte to ručne.

5. agy doctor

   Záverečná kontrola: binárny súbor, overenie totožnosti, doplnky, sieť. Ak sú všetky štyri položky zelené, migrácia konfigurácie je dokončená.

Starý priečinok .gemini/ by som nechal mesiac na mieste ako zálohu, keby sa na niečo zabudlo. Keď budete Antigravity používať týždeň a potvrdíte, že je tam všetko, môžete ho odstrániť.

Ak používate AGENTS.md ako univerzálnu konfiguráciu pre všetky nástroje AI, nemusíte ho upravovať. Antigravity CLI číta AGENTS.md z rovnakého priečinka ako Claude Code alebo Codex.

Ktoré premenné prostredia treba zmeniť?#

Úplná tabuľka náhrad:

Ak vaše GitHub Actions odovzdávajú secrets, otvorte Settings -> Secrets -> Actions a premenujte kľúče. Samotné hodnoty zostávajú rovnaké (kľúč Google API sa počas migrácie nezmenil).

Skontrolujte všetky miesta, kde sa môže nachádzať GEMINI_:

# Nájdite zmienky v celom projekte
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

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

Po nahradení reštartujte terminál a overte prítomnosť bez vypísania tajomstva. Nezapínajte sledovanie príkazov shellu a nekopírujte hodnoty kľúčov do logov. Samotná prítomnosť nedokazuje autorizáciu; agy doctor posúďte osobitne:

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        # malo by zobraziť „authorized“

Čo sa počas prechodu najčastejšie pokazí a ako to opraviť#

Zoznam počiatočných problémov:

1. Servery MCP. Ak ste používali mcp_servers v .gemini/config.json, po spustení agy plugin import gemini sa nemusia prevziať. Skontrolujte to pomocou agy inspect — zobrazí sa sekcia mcp. Ak je prázdna alebo obsahuje chyby, prepíšte ju ručne pomocou agy config --edit. Formát je opísaný v oficiálnej dokumentácii Antigravity (vyhľadajte sekciu MCP).

2. Vlastné háčiky. Ak ste mali skript bash v .gemini/hooks/, ktorý čítal $GEMINI_API_KEY, prestane fungovať. Nájdite takéto miesta: bash

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

   Nahraďte premenné.

3. CI/CD. V GitHub Actions alebo GitLab CI zmeňte kroky, ktoré používajú príkaz gemini, aby používali agy. Názov binárneho súboru v inštalátore sa môže líšiť, preto vytvorte abstrakciu pomocou premennej $CLI_CMD.

4. Rozšírenie IDE. Rozšírenie Gemini Code Assist pre VS Code sa vypne spolu s CLI. Náhradou je Antigravity IDE (samostatný fork VS Code) alebo AGENTS.md v ktoromkoľvek inom AI editore.

5. Načítanie @[file]. V prvých zostaveniach Antigravity CLI mal príkaz @src/file.ts na načítanie súboru do kontextu chyby. Aktualizujte na najnovšiu verziu: agy update.

Ak sa niečo kritické pokazí a nedá sa to opraviť do hodiny, dočasným riešením pre program Free je zostať pri Gemini CLI do 18. júna a migráciu pripravovať na samostatnej vetve repozitára. Časový limit: 14 dní.

Oplatí sa po 18. júni zostať pri nástrojoch Google?#

Antigravity 2.0 môžete zvážiť ako záložnú možnosť pre prípady, keď sa váš hlavný nástroj (Claude Code alebo Codex) nehodí. Podrobný pohľad na jeho silné a slabé stránky nájdete v sprievodcovi Google Antigravity 2.0.

Stručný prehľad toho, čo robiť podľa vašej situácie:

Migračný kontrolný zoznam za 15 minút#

1. Nainštalujte Antigravity CLI

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

2. Spustite agy a overte totožnosť

   Bez argumentov: agy. Vyberte OAuth alebo kľúč API.

3. Importujte doplnky z .gemini

   agy plugin import gemini — tým sa globálne premigrujú rozšírenia. Znova ho spustite v priečinku projektu, aby sa premigrovali doplnky pracovného priestoru.

4. Presuňte skills

   mv .gemini/skills/ .agents/skills/. Obsah súborov zostane nezmenený.

5. Nahraďte premenné prostredia

   V súboroch ~/.zshrc/~/.bashrc a .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Reštartujte terminál.

6. Overte inštaláciu

   agy doctor — všetky štyri položky (binárny súbor, overenie totožnosti, doplnky, sieť) majú byť zelené.

7. Spustite testovaciu úlohu

   agy "napíš README pre projekt v aktuálnom priečinku" — skontrolujte, či je výsledok podobný tomu, ktorý vytvorilo Gemini CLI.

8. Aktualizujte GitHub Actions / GitLab CI

   Zmeňte názov príkazu a secrets z GEMINI_* na AV_*.

9. Ponechajte .gemini/ ako zálohu

   Môžete ho odstrániť 1–2 týždne po potvrdení, že všetko funguje.

A napokon: 18. jún neznamená, že „všetky vaše projekty prestanú fungovať“. Znamená to, že sa vypne bezplatný kanál. Platený prístup ku Cloud API zostáva, repozitár Gemini CLI zostáva a forky sú možné. Ak ste používali program Free, musíte sa rozhodnúť pred 18. júnom; inak ďalší príkaz gemini "something" vráti chybu autorizácie.