# Migrace z Gemini CLI na Antigravity CLI: návod > Instalace agy, migrace konfigurace, pluginů a proměnných prostředí; kontroly, časté chyby a regionální omezení. Source: https://ailoot.ai/blog/cs/gemini-cli-antigravity-migraci/ Canonical: https://ailoot.ai/blog/cs/gemini-cli-antigravity-migraci/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-9fec014783684320a187483dd916f76d12ec33e11cde33837ddf7b61ed44585e Dne 19. května 2026 Google oznámil, že 18. června ukončí provoz starého Gemini CLI pro všechny tarify Free, Pro a Ultra. Dva týdny po zveřejnění tohoto návodu přestane příkaz `gemini` zpracovávat požadavky. Migrace z Gemini CLI na Antigravity CLI pomocí příkazu `agy` je jediný způsob, jak zůstat u nástrojů Google. `agy` je napsané v Go a spouští se desetkrát rychleji. Pokud máte cokoli spuštěného v Gemini CLI — skripty CI, noční úlohy cron, rozšíření Gemini Code Assist pro IDE — tento návod vysvětluje, jak vše přenést během jednoho večera, aniž byste něco rozbili.
Připojování modelů a práce s API jsou popsány v [dokumentaci Ailoot](https://ailoot.ai/docs/).
## Co se mění při ukončení Gemini CLI 18. června 2026?
Hlavní poznatek Dne 18. června 2026 přestanou Gemini CLI a rozšíření Gemini Code Assist pro VS Code zpracovávat požadavky pro tři skupiny uživatelů: tarif Free, Google AI Pro a Google AI Ultra. Nové instalace Gemini Code Assist na GitHubu již nebudou dostupné; stávající budou během následujících týdnů deaktivovány. Placený přístup k API prostřednictvím Gemini Enterprise Agent Platform a licencí Code Assist Standard/Enterprise bude fungovat dál beze změny.
Nejde o „úplné ukončení projektu“, ale o odstavení tří nejpopulárnějších tarifů. Koho se to týká: | Tarif | Co nabízel | Co se stane 18. června 2026 | |----|----|----| | Bezplatný tarif | Přístup ke Gemini Code Assist + CLI s omezeními | Bude zcela deaktivován | | Google AI Pro (asi \$19.99/měsíc) | Vyšší limity CLI a Code Assist | Bude zcela deaktivován | | Google AI Ultra (od \$100/měsíc po I/O 2026) | Nejvyšší limity | Bude zcela deaktivován | | Gemini Code Assist pro GitHub | Automatické kontroly PR od Googlu ve vašem repozitáři | Žádné nové instalace; stávající budou během následujících týdnů deaktivovány | | Gemini Code Assist Standard / Enterprise (firemní licence) | Prostřednictvím firemního účtu Google Workspace | Pokračuje beze změny | | Placené API přes Google Cloud (placený klíč Gemini API) | Požadavky se účtují projektu | Pokračuje beze změny | Z oficiálního blogu Google Developers:

Dne 18. června 2026 přestanou Gemini CLI a rozšíření Gemini Code Assist IDE zpracovávat požadavky pro uživatele Google AI Pro, Ultra a bezplatného tarifu.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Pokud jste používali bezplatný tarif, jako většina individuálních vývojářů, a říkáte si „ale mám placený účet“, přesně si ověřte, jak se účtuje váš klíč API. AI Pro není fakturace Cloud; jde o osobní předplatné Google AI a bude deaktivováno. Fakturace Cloud v rámci placeného projektu deaktivována nebude. ## Proč Google Gemini CLI vůbec ukončuje?
Hlavní poznatek Gemini CLI byl samostatný experiment v TypeScriptu/Node.js v repozitáři Google na GitHubu. Google se rozhodl sjednotit všechny své agentní nástroje pod jednu platformu — Google Antigravity — se čtyřmi rozhraními: Antigravity 2.0 (desktopová aplikace), Antigravity CLI (terminál), Antigravity SDK (wrapper pro Python) a Antigravity IDE (fork VS Code). Antigravity CLI bylo přepsáno z Node.js do Go: spouští se v milisekundách místo stovek milisekund a spotřebovává desítky megabajtů paměti místo stovek.
Staré `gemini` se spouštělo „stovky milisekund“, protože Node.js se musel zahřát. Nové `agy` je sestaveno jako jediný statický binární soubor Go a spouští se „v milisekundách“. U CI a skriptů, které CLI volají stokrát během jednoho běhu, je rozdíl výrazný. Co Google říká o rychlosti a důvodu:

Antigravity CLI je napsáno v Go, běží rychleji a podporuje asynchronní pracovní postupy na pozadí.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Všechny klíčové funkce Gemini CLI byly převedeny: - **Agent Skills** — složka `.gemini/skills/` je nyní v `.agents/skills/`. - **Hooks** — stejné události (`PreToolUse`, `PostToolUse` atd.); syntaxe se téměř nezměnila. - **Subagents** — fungují jako dříve a jejich konfigurace se migruje automaticky. - **Extensions** — přejmenované na pluginy Antigravity a importované jediným příkazem. Co se nepřevedlo hladce: servery MCP a staré skripty, které přímo přistupují k `.gemini/config.json`. Podle diskuse na GitHubu někteří uživatelé hlásí, že konfigurace MCP nefungují a je nutné je přepsat ručně. Této problematice je věnována samostatná část níže. Google open-source projekt Gemini CLI neuzavírá:

Repozitář zůstane dostupný na GitHubu pod licencí Apache 2.0 a budeme na projektu pokračovat jako na open-source.

— Google Developers Blog (Discussion #27274)
To znamená, že si jej můžete forknout a pokračovat v používání s vlastním klíčem Gemini API. Teď však jde o placené nastavení přes fakturaci Cloud; bezplatná nabídka Code Assist končí. ## Jak nainstalovat Antigravity CLI: příkazy pro macOS, Linux a Windows
Hlavní poznatek Instalační program Googlu automaticky rozpozná operační systém a architekturu, stáhne binární soubor a umístí jej do `~/.local/bin` (Linux/macOS) nebo `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Příkazy se pro tři operační systémy liší: v macOS a Linuxu jde o jednořádkový příkaz s `curl`; ve Windows buď PowerShell `irm`, nebo varianta pro CMD. Po instalaci přidejte cestu do `PATH`, pokud to instalační program neudělal, otevřete nový terminál a spusťte `agy doctor` — ověří, že byl nalezen binární soubor a že se může spojit s Googlem.
Než začnete, rychle si ověřte, jaký máte tarif. Pokud máte placený projekt Cloud a žádný termín 18. června vás netlačí, migrace se hodí, ale není naléhavá. Pokud používáte Free/Pro/Ultra a máte něco spuštěného v CLI, přejděte teď, dokud jsou tarify stále aktivní, a porovnejte chování při stejném úkolu. ### macOS a Linux Jednořádkový příkaz s `curl`: ```bash curl -fsSL https://antigravity.google/cli/install.sh | bash ``` Skript rozpozná platformu, stáhne binární soubor `agy`, zkontroluje jeho kontrolní součet a umístí jej do `~/.local/bin`. Pokud tato složka není v `PATH`, přidejte ji: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Ověřte, že je binární soubor dostupný: ```bash which agy agy --version ``` ### Windows (PowerShell) ```powershell irm https://antigravity.google/cli/install.ps1 | iex ``` Binární soubor se nainstaluje do `C:\Users\[your_name]\AppData\Local\agy\bin`. Instalační program automaticky aktualizuje PATH, ale otevřete nové okno PowerShellu, aby se proměnné znovu načetly. ### Windows (CMD) Pokud vaše firemní zásady blokují PowerShell: ```cmd curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd ``` ### Ověření instalace Po instalaci na jakémkoli operačním systému spusťte: ```bash agy doctor ``` Příkaz kontroluje verzi binárního souboru, zda existuje konfigurace, ověření a přístup k síti `antigravity.google`. Pokud se nemůže spojit s Googlem, problém je ve vašem regionu nebo proxy. ### Ověření totožnosti Při prvním spuštění `agy` bez argumentů se otevře průvodce nastavením: 1. Vyberte motiv rozhraní. 2. Vyberte způsob ověření: Google OAuth (pro osobní účty) nebo klíč API. 3. Volitelně ihned importujte konfiguraci z `.gemini/`. Pokud zvolíte OAuth, otevře se prohlížeč a přesměruje vás na `accounts.google.com`; musíte souhlasit se sdílením údajů. Poté bude CLI fungovat. ## Jak migrovat konfiguraci a pluginy z .gemini do .agents
Hlavní poznatek Antigravity CLI hledá konfiguraci v `.agents/` vedle projektu a globálně v `~/.agents/` — stejně jako Gemini CLI hledalo v `.gemini/`. Migrace se provádí jediným příkazem `agy plugin import gemini`: projde `.gemini/extensions/`, převede je na pluginy Antigravity a aktualizuje formát konfigurace. Složku skills přesuňte ručně: `mv .gemini/skills/ .agents/skills/`. Poté `agy doctor` a `agy inspect` ukážou, co bylo načteno, co ne a kde jsou duplicity.
Postup: 1. ### agy plugin import gemini Příkaz spusťte z libovolné složky. Migruje globální pluginy z `~/.gemini/` do `~/.agents/`. U pluginů workspace (vedle projektu) spusťte příkaz ve složce projektu. 2. ### mv .gemini/skills/ .agents/skills/ Skills přesuňte ručním přejmenováním složky. Formát souborů uvnitř je stejný; Markdown není třeba přepisovat. 3. ### agy inspect Zobrazí aktivní pluginy, skills, hooks a subagenty. Porovnejte je se seznamem v Gemini CLI — nic by nemělo chybět. 4. ### agy config --edit Otevře konfiguraci v předvoleném editoru (`$EDITOR`). Pokud se něco nepřevedlo automaticky, upravte to ručně. 5. ### agy doctor Závěrečná kontrola: binární soubor, ověření, pluginy, síť. Pokud jsou všechny čtyři položky zelené, migrace konfigurace je hotová. Starou složku `.gemini/` bych nechal jako zálohu měsíc pro případ, že by něco chybělo. Až budete Antigravity používat týden a ověříte, že je vše na svém místě, můžete ji smazat. Pokud používáte [AGENTS.md jako univerzální konfiguraci pro všechny nástroje AI](https://ailoot.ai/blog/cs/agents-md-guide-template/), nemusíte na ni sahat. Antigravity CLI načítá `AGENTS.md` ze stejné složky jako Claude Code nebo Codex. ## Které proměnné prostředí je třeba změnit?
Hlavní poznatek Pokud máte skripty CI/CD, GitHub Actions, místní soubory `.env` nebo dotfiles, které předávají `GEMINI_API_KEY` nebo jiné proměnné, musíte je přejmenovat. Prefix `GEMINI_` se změnil na `AV_` (pro Antigravity). Antigravity CLI staré proměnné NEČTE.
Úplná tabulka náhrad: | Stará proměnná (Gemini CLI) | Nová proměnná (Antigravity CLI) | Výchozí 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ální koncový bod Google | Pokud máte v GitHub Actions předávané tajné údaje, otevřete `Settings -> Secrets -> Actions` a přejmenujte klíče. Samotné hodnoty zůstávají stejné (klíč Google API se při migraci nezměnil). Zkontrolujte všechna místa, kde se může vyskytovat `GEMINI_`: ```bash # Find mentions throughout the project grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null # In dotfiles grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null ``` Po nahrazení proměnných restartujte terminál a ověřte přítomnost bez vypsání tajného údaje. Nezapínejte sledování příkazů shellu ani nekopírujte hodnoty klíčů do logů. Samotná přítomnost neprokazuje přihlášení; `agy doctor` ověřte samostatně: ```bash if [ -n "${AV_API_KEY:-}" ]; then printf 'AV_API_KEY je nastavena\n' else printf 'AV_API_KEY chybí nebo je prázdná\n' fi agy doctor # should show “authorized” ``` ## Co se při přechodu nejčastěji rozbije a jak to opravit
Hlavní poznatek Podle diskuse na GitHubu jsou nejčastější problémy servery MCP definované v `~/.gemini/config.json`, které se nenačtou automaticky — konfiguraci je třeba přepsat do formátu Antigravity. Vlastní hooks používající staré proměnné prostředí selhávají potichu, takže testy selžou bez jasné chyby. Skripty, které přistupují přímo k `.gemini/` (místo přes CLI), je třeba přesměrovat na `.agents/`. Příkaz `@[file]` pro načtení souboru do kontextu měl při prvním vydání Antigravity CLI chyby; v novějších sestaveních už byly opraveny, ale pokud máte starší verzi, aktualizujte ji.
Seznam počátečních problémů: 1. **Servery MCP.** Pokud jste v `.gemini/config.json` používali `mcp_servers`, po `agy plugin import gemini` se nemusí načíst. Ověřte to příkazem `agy inspect` — bude tam část `mcp`. Pokud je prázdná nebo obsahuje chyby, přepište konfiguraci ručně pomocí `agy config --edit`. Formát je popsán v oficiální dokumentaci Antigravity (hledejte část MCP). 2. **Vlastní hooks.** Pokud jste měli skript bash v `.gemini/hooks/`, který četl `$GEMINI_API_KEY`, přestane fungovat. Najděte taková místa: bash ``` grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null ``` Nahraďte proměnné. 3. **CI/CD.** V GitHub Actions nebo GitLab CI změňte kroky, které používají příkaz `gemini`, na `agy`. Název binárního souboru v instalačním programu se může lišit, proto vytvořte abstrakci pomocí proměnné `$CLI_CMD`. 4. **Rozšíření IDE.** Rozšíření Gemini Code Assist pro VS Code bude deaktivováno spolu s CLI. Náhradou je [Antigravity IDE](https://antigravity.google) (samostatný fork VS Code) nebo AGENTS.md v jiném editoru AI. 5. **Načítání `@[file]`.** V prvních sestaveních Antigravity CLI mělo načítání souboru do kontextu příkazem `@src/file.ts` chyby. Aktualizujte na nejnovější verzi: `agy update`. Pokud se něco kritického rozbije a nepodaří se to opravit do hodiny, dočasným řešením pro tarif Free je zůstat u Gemini CLI do 18. června a zároveň připravovat migraci na samostatné větvi repozitáře. Časový limit: 14 dní. ## Má smysl zůstat po 18. červnu u nástrojů Google?
Hlavní poznatek Antigravity CLI se spouští rychleji, funguje s Gemini 3.5 Flash, podporuje paralelní agenty a asynchronní úlohy na pozadí pomocí `agy --background`. Má však dva potenciální problémy: regionální omezení přístupu a nezralý ekosystém (méně pluginů a serverů MCP než Claude Code). Nedoporučoval bych přejít na Antigravity jako na svůj hlavní nástroj. Používal bych ho jako záložní kanál pro paralelní úlohy na pozadí a hlavní vývoj nechal v Claude Code. Pokud jste používali Gemini CLI v rámci bezplatného tarifu, 18. červen je vhodnou chvílí k přehodnocení celé sady nástrojů.
Antigravity 2.0 lze zvážit jako záložní možnost pro případy, kdy se váš hlavní nástroj (Claude Code nebo Codex) nehodí. Podrobný pohled na jeho přednosti a slabiny najdete v [návodu k Google Antigravity 2.0](https://ailoot.ai/blog/cs/google-antigravity/). Stručně: co dělat podle vaší situace: | Pokud... | Co udělat do 18. června | |----|----| | Používali jste bezplatné Gemini CLI k experimentům | Přejděte na Antigravity CLI s účtem, který má ke službě přístup, NEBO přejděte na Claude/Codex — podle rozpočtu | | Používali jste Gemini Code Assist v IDE | Přejděte na Antigravity IDE nebo se vraťte k VS Code + Claude Code | | Spouštěli jste noční úlohy cron přes Gemini API v bezplatném tarifu | Naléhavě je přepište na placené API Cloud (které nebude deaktivováno), NEBO přejděte na Claude API | | Pracujete přes firemní Cloud (Standard/Enterprise) | Nedělejte nic; ukončení se vás netýká | | Přemýšleli jste, že Gemini CLI vyzkoušíte, protože „je zdarma“ | Nezačínejte; přejděte rovnou na [Claude Code](https://ailoot.ai/blog/cs/claude-code/) nebo [Codex](https://ailoot.ai/blog/cs/codex-vs-claude-code-choice/) | ## Migrační kontrolní seznam za 15 minut
Hlavní poznatek Pokud chcete nejrychlejší postup bez čtení celého návodu, zde je stručná posloupnost. Na čistém terminálu bez aktivních skriptů Gemini zabere celá migrace 10–20 minut.
1. ### Nainstalujte Antigravity CLI `curl -fsSL https://antigravity.google/cli/install.sh | bash` (macOS/Linux) nebo `irm https://antigravity.google/cli/install.ps1 | iex` (Windows PowerShell). 2. ### Spusťte agy a ověřte se Bez argumentů: `agy`. Vyberte OAuth nebo klíč API. 3. ### Importujte pluginy z .gemini `agy plugin import gemini` — tím se globálně migrují extensions. Pro pluginy workspace příkaz spusťte znovu ve složce projektu. 4. ### Přesuňte skills `mv .gemini/skills/ .agents/skills/`. Obsah souborů zůstane stejný. 5. ### Nahraďte proměnné prostředí V souborech `~/.zshrc`/`~/.bashrc` a `.env`: `GEMINI_API_KEY → AV_API_KEY`, `GEMINI_PROJECT_ID → AV_PROJECT_ID`, `GEMINI_REGION → AV_REGION`. Restartujte terminál. 6. ### Ověřte instalaci `agy doctor` — všechny čtyři položky (binární soubor, ověření, pluginy, síť) by měly být zelené. 7. ### Spusťte zkušební úlohu `agy "write a README for the project in the current folder"` — ověřte, že výsledek je podobný tomu, který vytvářelo Gemini CLI. 8. ### Aktualizujte GitHub Actions / GitLab CI Změňte název příkazu a tajné údaje z `GEMINI_*` na `AV_*`. 9. ### Ponechte .gemini/ jako zálohu Můžete ji smazat 1–2 týdny poté, co ověříte, že vše funguje. A nakonec: 18. červen neznamená, že „všechny vaše projekty přestanou fungovat“. Znamená to, že bude deaktivován bezplatný kanál. Placený přístup k API Cloud zůstává, repozitář Gemini CLI zůstává a forky jsou možné. Pokud jste používali tarif Free, musíte se rozhodnout před 18. červnem; jinak příští `gemini "something"` vrátí chybu autorizace.
### Zdroje - [Google Developers Blog - An important update: Transitioning Gemini CLI to Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Getting Started](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - GitHub repository](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Google I/O 2026 developer highlights](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/).
## Časté otázky ### Jak ověřit přejmenovanou proměnnou klíče API bez zveřejnění? Otestujte neprázdnost `${AV_API_KEY:-}` a vypište jen informaci nastaveno/chybí. Hodnotu nevypisujte a kontrolu nespouštějte se sledováním příkazů shellu. Přihlášení samostatně ověřte pomocí `agy doctor`. ### Dokazuje úspěšný import konfigurace dokončenou migraci? Ne. Porovnejte aktivní pluginy, skilly, hooky a podagenty se starou konfigurací, prohlédněte nastavení MCP a spusťte malý úkol. Starou konfiguraci `.gemini/` zachovejte, dokud neověříte zamýšlený postup i výsledek. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.