Migracja z Gemini CLI do Antigravity CLI: przewodnik

19 maja 2026 r. Google ogłosiło, że 18 czerwca wyłączy dotychczasowe Gemini CLI we wszystkich planach Free, Pro i Ultra. Dwa tygodnie po publikacji tego przewodnika polecenie gemini przestanie przetwarzać żądania. Migracja z Gemini CLI do Antigravity CLI za pomocą polecenia agy to jedyny sposób, by pozostać przy narzędziach Google. agy jest zbudowane w Go i uruchamia się kilkadziesiąt razy szybciej.

Jeśli masz coś działającego na Gemini CLI — skrypty CI, nocne zadania cron albo rozszerzenie IDE Gemini Code Assist — ten przewodnik wyjaśnia, jak przenieść wszystko w jeden wieczór, nie psując niczego.

Co dokładnie przestanie działać 18 czerwca 2026 r.?#

Nie chodzi o „całkowite zamknięcie projektu”, lecz o zakończenie obsługi trzech najpopularniejszych planów. Oto kogo dotyczy zmiana:

Z oficjalnego bloga Google Developers Blog:

Jeśli korzystasz z planu Free, tak jak większość indywidualnych programistów, i myślisz: „ale mam płatne konto” — dokładnie sprawdź, jak rozliczany jest Twój klucz API. AI Pro nie oznacza rozliczeń Cloud; to osobista subskrypcja Google AI, która zostanie wyłączona. Rozliczenia Cloud w ramach płatnego projektu nie zostaną wyłączone.

Dlaczego Google w ogóle zamyka Gemini CLI?#

Stare gemini uruchamiało się w „setkach milisekund”, ponieważ Node.js potrzebował czasu na rozgrzanie. Nowe agy jest zbudowane jako pojedynczy statyczny plik binarny Go i uruchamia się w „milisekundach”. W przypadku CI i skryptów, które wywołują CLI setki razy w jednym przebiegu, różnica jest znacząca.

O szybkości i jej przyczynach Google mówi tak:

Wszystkie najważniejsze funkcje Gemini CLI zostały przeniesione:

• Agent Skills — folder .gemini/skills/ znajduje się teraz w .agents/skills/.
• Hooks — zdarzenia są takie same (PreToolUse, PostToolUse itd.); składnia prawie się nie zmieniła.
• Subagents — działają jak wcześniej, a ich konfiguracja jest migrowana automatycznie.
• Extensions — przemianowane na wtyczki Antigravity i importowane jednym poleceniem.

Co nie przeniosło się bezproblemowo: serwery MCP i stare skrypty, które bezpośrednio uzyskują dostęp do .gemini/config.json. Według dyskusji na GitHubie niektórzy użytkownicy zgłaszają, że konfiguracje MCP przestają działać i trzeba je ręcznie przepisać. Poniżej znajduje się osobna sekcja na ten temat.

Google nie zamyka otwartoźródłowego projektu Gemini CLI:

Możesz więc utworzyć jego fork i nadal używać go z własnym kluczem Gemini API. Będzie to jednak płatna konfiguracja rozliczana przez Cloud; bezpłatny model korzystania z Code Assist dobiega końca.

Jak zainstalować Antigravity CLI: polecenia dla macOS, Linuxa i Windows#

Zanim zaczniesz, szybko sprawdź, z którego planu korzystasz. Jeśli masz płatny projekt Cloud i nie dotyczy Cię termin 18 czerwca, migracja może być przydatna, ale nie jest pilna. Jeśli korzystasz z Free/Pro/Ultra i coś działa w CLI, przełącz się już teraz, gdy plany są jeszcze aktywne, aby porównać działanie na tym samym zadaniu.

macOS i Linux

Jednolinijkowe polecenie z curl:

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

Skrypt wykrywa platformę, pobiera plik binarny agy, sprawdza jego sumę kontrolną i umieszcza go w ~/.local/bin. Jeśli tego folderu nie ma w PATH, dodaj go:

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

Sprawdź, czy plik binarny jest widoczny:

which agy
agy --version

Windows (PowerShell)

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

Plik binarny zostanie zainstalowany w C:\Users\[your_name]\AppData\Local\agy\bin. Instalator automatycznie zaktualizuje PATH, ale otwórz nowe okno PowerShell, aby ponownie wczytać zmienne.

Windows (CMD)

Jeśli zasady firmowe blokują PowerShell:

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

Sprawdź instalację

Po instalacji w dowolnym systemie uruchom:

agy doctor

Polecenie sprawdza wersję pliku binarnego, obecność konfiguracji, uwierzytelnienie i dostęp sieciowy do antigravity.google. Jeśli nie może połączyć się z Google, problem dotyczy regionu lub serwera proxy.

Uwierzytelnianie

Przy pierwszym uruchomieniu agy bez argumentów pojawi się kreator konfiguracji:

1. Wybierz motyw interfejsu.
2. Wybierz metodę uwierzytelniania: Google OAuth (dla kont osobistych) albo klucz API.
3. Opcjonalnie od razu zaimportuj konfigurację z .gemini/.

Jeśli wybierzesz OAuth, otworzy się przeglądarka i przekieruje Cię do accounts.google.com; musisz wyrazić zgodę na udostępnianie danych. Potem CLI będzie działać.

Jak przenieść konfigurację i wtyczki z .gemini do .agents#

Krok po kroku:

1. agy plugin import gemini

   Uruchom polecenie z dowolnego folderu. Przeniesie globalne wtyczki z ~/.gemini/ do ~/.agents/. Aby przenieść wtyczki obszaru roboczego (znajdujące się obok projektu), uruchom polecenie w folderze projektu.

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

   Przenieś skills, ręcznie zmieniając nazwę folderu. Format znajdujących się w nim plików jest taki sam, więc nie trzeba przepisywać Markdownu.

3. agy inspect

   Pokazuje aktywne wtyczki, skills, hooks i subagents. Porównaj wynik z listą używaną w Gemini CLI — nie powinno być żadnych braków.

4. agy config --edit

   Otwiera konfigurację w domyślnym edytorze ($EDITOR). Jeśli coś nie zostało automatycznie wykryte, edytuj to ręcznie.

5. agy doctor

   Ostateczna kontrola: plik binarny, uwierzytelnienie, wtyczki i sieć. Jeśli wszystkie cztery pozycje są oznaczone na zielono, migracja konfiguracji jest zakończona.

Zostawiłbym stary folder .gemini/ jako kopię zapasową na miesiąc, na wypadek gdyby czegoś brakowało. Po tygodniu korzystania z Antigravity i potwierdzeniu, że wszystko jest na miejscu, możesz go usunąć.

Jeśli używasz AGENTS.md jako uniwersalnej konfiguracji dla wszystkich narzędzi AI, nie musisz niczego w nim zmieniać. Antigravity CLI odczytuje AGENTS.md z tego samego folderu co Claude Code lub Codex.

Które zmienne środowiskowe trzeba zmienić?#

Pełna tabela zamienników:

Jeśli GitHub Actions przekazuje sekrety, otwórz Settings -> Secrets -> Actions i zmień nazwy kluczy. Same wartości pozostają takie same (klucz Google API nie zmienił się podczas migracji).

Sprawdź wszystkie miejsca, które mogą zawierać GEMINI_:

# Wyszukaj wystąpienia w całym projekcie
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

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

Po zamianie uruchom terminal ponownie i sprawdź obecność zmiennej bez drukowania sekretu. Nie włączaj śledzenia powłoki ani nie kopiuj kluczy do logów. Sama obecność nie dowodzi autoryzacji; osobno sprawdź agy doctor:

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        # should show “authorized”

Co najczęściej psuje się podczas przejścia i jak to naprawić#

Lista początkowych problemów do sprawdzenia:

1. Serwery MCP. Jeśli używałeś mcp_servers w .gemini/config.json, po agy plugin import gemini mogą nie zostać przeniesione. Sprawdź to poleceniem agy inspect — będzie tam sekcja mcp. Jeśli jest pusta lub zawiera błędy, przepisz konfigurację ręcznie za pomocą agy config --edit. Format opisano w oficjalnej dokumentacji Antigravity w sekcji MCP.

2. Własne hooks. Jeśli w .gemini/hooks/ masz skrypt bash odczytujący $GEMINI_API_KEY, przestanie działać. Znajdź takie miejsca:

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

   Zastąp zmienne.

3. CI/CD. W GitHub Actions lub GitLab CI zmień kroki korzystające z polecenia gemini na agy. Nazwa pliku binarnego w instalatorze może się różnić, dlatego utwórz abstrakcję korzystającą ze zmiennej $CLI_CMD.

4. Rozszerzenie IDE. Rozszerzenie Gemini Code Assist dla VS Code zostanie wyłączone razem z CLI. Zastąpi je Antigravity IDE (osobny fork VS Code) albo AGENTS.md w innym edytorze AI.

5. Wczytywanie @[file]. Wczesne kompilacje Antigravity CLI zawierały błędy w poleceniu @src/file.ts służącym do wczytywania pliku do kontekstu. Zaktualizuj do najnowszej wersji: agy update.

Jeśli wystąpi krytyczny problem, którego nie da się naprawić w ciągu godziny, tymczasowym rozwiązaniem dla planu Free jest dalsze korzystanie z Gemini CLI do 18 czerwca i przygotowywanie migracji w osobnej gałęzi repozytorium. Limit czasu: 14 dni.

Czy po 18 czerwca warto pozostać przy narzędziach Google?#

Antigravity 2.0 można rozważyć jako opcję zapasową na wypadek, gdyby główne narzędzie (Claude Code lub Codex) się nie sprawdzało. Szczegółowy opis jego zalet i wad znajdziesz w przewodniku po Google Antigravity 2.0.

Krótko: co zrobić w zależności od sytuacji:

Lista migracyjna do wykonania w 15 minut#

1. Zainstaluj Antigravity CLI

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

2. Uruchom agy i uwierzytelnij się

   Uruchom bez argumentów: agy. Wybierz OAuth albo klucz API.

3. Zaimportuj wtyczki z .gemini

   agy plugin import gemini — polecenie przenosi rozszerzenia globalnie. Uruchom je ponownie w folderze projektu, aby przenieść wtyczki obszaru roboczego.

4. Przenieś skills

   mv .gemini/skills/ .agents/skills/. Zawartość plików pozostaje bez zmian.

5. Zastąp zmienne środowiskowe

   W plikach ~/.zshrc/~/.bashrc i .env zamień: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Uruchom ponownie terminal.

6. Sprawdź instalację

   Uruchom agy doctor — wszystkie cztery pozycje (plik binarny, uwierzytelnienie, wtyczki, sieć) powinny być oznaczone na zielono.

7. Wykonaj zadanie testowe

   Uruchom agy "write a README for the project in the current folder" — sprawdź, czy wynik jest podobny do tego wygenerowanego przez Gemini CLI.

8. Zaktualizuj GitHub Actions / GitLab CI

   Zmień nazwę polecenia i sekrety z GEMINI_* na AV_*.

9. Zachowaj .gemini/ jako kopię zapasową

   Możesz usunąć ten folder 1–2 tygodnie po potwierdzeniu, że wszystko działa.

Na koniec: 18 czerwca nie oznacza, że „wszystkie Twoje projekty przestaną działać”. Wyłączony zostanie bezpłatny kanał. Płatny dostęp do Cloud API pozostaje, repozytorium Gemini CLI również, a forki nadal są możliwe. Jeśli korzystasz z planu Free, musisz podjąć decyzję przed 18 czerwca; w przeciwnym razie następne gemini "something" zwróci błąd uwierzytelniania.