Migrace z Gemini CLI na Antigravity CLI: návod

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.

Co se mění při ukončení Gemini CLI 18. června 2026?#

Nejde o „úplné ukončení projektu“, ale o odstavení tří nejpopulárnějších tarifů. Koho se to týká:

Z oficiálního blogu Google Developers:

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?#

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:

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á:

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#

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:

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:

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

Ověřte, že je binární soubor dostupný:

which agy
agy --version

Windows (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:

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:

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#

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, 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?#

Úplná tabulka náhrad:

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_:

# 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ě:

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#

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 (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?#

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.

Stručně: co dělat podle vaší situace:

Migrační kontrolní seznam za 15 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.