# Migrácia z Gemini CLI na Antigravity CLI: Sprievodca > Inštalácia agy, migrácia konfigurácie, doplnkov a premenných prostredia; kontroly, časté chyby a regionálne obmedzenia. Source: https://ailoot.ai/blog/sk/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/sk/gemini-cli-to-antigravity-cli-migration/ Language: sk Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-bd7c17c296d534dfa0b8b50d7084c27d90231926790090daeab415fbefc17e37 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.
Pripájanie modelov a práca s API sú opísané v [dokumentácii Ailoot](https://ailoot.ai/docs/).
## Čo presne prestane fungovať 18. júna 2026?
Hlavné zistenie 18. júna 2026 prestanú Gemini CLI a rozšírenie Gemini Code Assist pre VS Code spracúvať požiadavky pre tri kategórie používateľov: program Free, Google AI Pro a Google AI Ultra. Nové inštalácie Gemini Code Assist na GitHube už nebudú dostupné; existujúce budú zakázané „v nasledujúcich týždňoch“. Platený prístup k API cez Gemini Enterprise Agent Platform a licencie Code Assist Standard/Enterprise bude naďalej fungovať bez zmien.
Nejde o „úplné ukončenie projektu“, ale o odstavenie troch najpopulárnejších programov. Koho sa to týka: | Program | Čo ponúkal | Čo sa stane 18. júna 2026 | |----|----|----| | Bezplatný program | Prístup ku Gemini Code Assist + CLI s obmedzeniami | Úplne sa vypne | | Google AI Pro (približne \$19.99/mesiac) | Vyššie limity pre CLI a Code Assist | Úplne sa vypne | | Google AI Ultra (od \$100/mesiac po I/O 2026) | Najvyššie limity | Úplne sa vypne | | Gemini Code Assist pre GitHub | Automatické kontroly PR od Googlu vo vašom repozitári | Žiadne nové inštalácie; existujúce sa vypnú v nasledujúcich týždňoch | | Gemini Code Assist Standard / Enterprise (firemné licencie) | Cez firemný účet Google Workspace | Pokračuje bez zmien | | Platené API cez Google Cloud (platený kľúč Gemini API) | Požiadavky sa účtujú projektu | Pokračuje bez zmien | Z oficiálneho blogu Google Developers Blog:

18. júna 2026 prestanú Gemini CLI a rozšírenia Gemini Code Assist IDE spracúvať požiadavky používateľov programov Google AI Pro, Ultra a Free.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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?
Hlavné zistenie Gemini CLI bol samostatný experiment v TypeScript/Node.js v repozitári Googlu na GitHube. Google sa rozhodol zjednotiť všetky svoje agentové nástroje na jednej platforme — Google Antigravity — so štyrmi rozhraniami: Antigravity 2.0 (desktopová aplikácia), Antigravity CLI (terminál), Antigravity SDK (obal pre Python) a Antigravity IDE (fork VS Code). Antigravity CLI bol prepísaný z Node.js do Go: spúšťa sa za milisekundy namiesto stoviek milisekúnd a využíva desiatky megabajtov pamäte namiesto stoviek.
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:

Antigravity CLI je napísaný v Go, beží rýchlejšie a podporuje asynchrónne pracovné postupy na pozadí.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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:

Repozitár zostane dostupný na GitHube pod licenciou Apache 2.0 a na projekte budeme naďalej pracovať ako na projekte s otvoreným zdrojovým kódom.

— Google Developers Blog (Discussion #27274)
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
Hlavné zistenie Inštalátor Googlu automaticky rozpozná operačný systém a architektúru, stiahne binárny súbor a uloží ho do `~/.local/bin` (Linux/macOS) alebo `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Príkazy sa v troch operačných systémoch líšia: v macOS a Linuxe použijete jeden príkaz s `curl`; vo Windows buď PowerShell `irm`, alebo možnosť CMD. Po inštalácii pridajte cestu do `PATH`, ak to inštalátor neurobil, otvorte nový terminál a spustite `agy doctor` — skontroluje, či sa binárny súbor našiel a dokáže sa pripojiť ku Googlu.
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`: ```bash 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: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Skontrolujte, či je binárny súbor dostupný: ```bash which agy agy --version ``` ### Windows (PowerShell) ```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: ```cmd 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: ```bash 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
Hlavné zistenie Antigravity CLI hľadá svoju konfiguráciu v `.agents/` vedľa projektu a globálne v `~/.agents/` — rovnako ako Gemini CLI hľadalo v `.gemini/`. Migrácia sa vykoná jedným príkazom, `agy plugin import gemini`: prejde `.gemini/extensions/`, premigruje ich ako doplnky Antigravity a aktualizuje formát konfigurácie. Priečinok skills presuňte ručne: `mv .gemini/skills/ .agents/skills/`. Potom `agy doctor` a `agy inspect` zobrazia, čo sa prevzalo, čo nie a kde sú duplikáty.
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](https://ailoot.ai/blog/sk/agents-md-guide-template/), nemusíte ho upravovať. Antigravity CLI číta `AGENTS.md` z rovnakého priečinka ako Claude Code alebo Codex. ## Ktoré premenné prostredia treba zmeniť?
Hlavné zistenie Ak máte skripty CI/CD, GitHub Actions, lokálne súbory `.env` alebo dotfiles, ktoré odovzdávajú `GEMINI_API_KEY` alebo iné premenné, musíte ich premenovať. Predpona `GEMINI_` sa zmenila na `AV_` (pre Antigravity). Antigravity CLI staré premenné NEČÍTA.
Úplná tabuľka náhrad: | Stará premenná (Gemini CLI) | Nová premenná (Antigravity CLI) | Predvolená hodnota | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Oficiálny endpoint Googlu | 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_`: ```bash # 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: ```bash 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ť
Hlavné zistenie Podľa diskusie na GitHube sú najčastejším problémom servery MCP definované v `~/.gemini/config.json`, ktoré sa neprevezmú automaticky — konfiguráciu treba prepísať do formátu Antigravity. Vlastné háčiky používajúce staré premenné prostredia zlyhávajú potichu, takže testy zlyhajú bez jasnej chyby. Skripty, ktoré pristupujú priamo k `.gemini/` (namiesto cez CLI), treba upraviť tak, aby používali `.agents/`. Príkaz `@[file]` na načítanie súboru do kontextu mal chyby pri prvom spustení Antigravity CLI; v novších zostaveniach sú opravené, ale ak používate staršiu verziu, aktualizujte ju.
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](https://antigravity.google) (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?
Hlavné zistenie Antigravity CLI sa spúšťa rýchlejšie, funguje s Gemini 3.5 Flash a podporuje paralelných agentov aj asynchrónne úlohy na pozadí cez `agy --background`. Existujú však dva možné problémy: regionálne obmedzenia prístupu a nezrelý ekosystém (menej doplnkov a serverov MCP než v Claude Code). Antigravity by som nemigroval na svoj hlavný nástroj. Používal by som ho ako záložný kanál pre paralelné úlohy na pozadí a hlavnú vývojársku prácu by som ponechal v Claude Code. Ak ste používali Gemini CLI v rámci programu Free, 18. jún je vhodný okamih na prehodnotenie celej súpravy nástrojov.
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](https://ailoot.ai/blog/sk/google-antigravity/). Stručný prehľad toho, čo robiť podľa vašej situácie: | Ak... | Čo urobiť do 18. júna | |----|----| | Používali ste bezplatné Gemini CLI na experimenty | Prejdite na Antigravity CLI s účtom, ktorý má k službe prístup, ALEBO prejdite na Claude/Codex — podľa svojho rozpočtu | | Používali ste Gemini Code Assist vo svojom IDE | Prejdite na Antigravity IDE alebo sa vráťte k VS Code + Claude Code | | Spúšťali ste nočné úlohy cron cez Gemini API v bezplatnom programe | Naliehavo ich prepíšte pre platené Cloud API (ktoré sa nevypne) ALEBO ich presuňte na Claude API | | Pracujete cez firemný Cloud (Standard/Enterprise) | Nerobte nič; odstavenie sa vás netýka | | Uvažovali ste, že vyskúšate Gemini CLI, len preto, že „je zadarmo“ | Nezačínajte; prejdite rovno na [Claude Code](https://ailoot.ai/blog/sk/claude-code/) alebo [Codex](https://ailoot.ai/blog/sk/codex-vs-claude-code-choice/) | ## Migračný kontrolný zoznam za 15 minút
Hlavné zistenie Ak chcete najrýchlejší postup bez čítania celého sprievodcu, tu je stručná postupnosť. V novom termináli bez aktívnych skriptov Gemini trvá celá migrácia 10–20 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.
### Zdroje - [Google Developers Blog - Dôležitá aktualizácia: prechod z Gemini CLI na Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Začíname](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - Repozitár na GitHube](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Významné novinky pre vývojárov z Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Pokračujte v práci s AI na [Ailoot](https://ailoot.ai/).
## Otázky a odpovede: Migrácia z Gemini CLI na Antigravity CLI: Sprievodca ### Ako overiť premenovanú premennú kľúča API bez jej odhalenia? Overte, či je hodnota ${AV_API_KEY:-} neprázdna, a vypíšte iba správu o prítomnosti alebo chýbaní. Hodnotu kľúča nevypisujte cez echo a kontrolu nespúšťajte so sledovaním shellu; autentifikáciu posúďte osobitne cez agy doctor. ### Dokazuje úspešný import konfigurácie dokončenie migrácie? Nie. Porovnajte aktívne pluginy, skills, hooky a subagentov so starou konfiguráciou, prezrite nastavenia MCP a vykonajte malú úlohu. Starú konfiguráciu .gemini/ ponechajte, kým nebude overený zamýšľaný postup aj výsledok. ## Ailoot · Spoločnosť a jej portfólio projektov Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI. Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách. Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.