# Migracja z Gemini CLI do Antigravity CLI: przewodnik > Instalacja agy, migracja konfiguracji, wtyczek i zmiennych środowiskowych; kontrole, typowe błędy i ograniczenia regionalne. Source: https://ailoot.ai/blog/pl/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/pl/gemini-cli-to-antigravity-cli-migration/ Language: pl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-85114e23877ca267670f7dc6cf3eb15de63355b347059a764322bb0c0af1b735 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.
Informacje o podłączaniu modeli i korzystaniu z API znajdziesz w [dokumentacji Ailoot](https://ailoot.ai/docs/).
## Co dokładnie przestanie działać 18 czerwca 2026 r.?
Najważniejsze informacje 18 czerwca 2026 r. Gemini CLI i rozszerzenie Gemini Code Assist IDE dla VS Code przestaną przetwarzać żądania dla trzech kategorii użytkowników: planu Free, Google AI Pro i Google AI Ultra. Nowe instalacje Gemini Code Assist na GitHubie nie będą już dostępne; istniejące zostaną wyłączone „w ciągu kolejnych tygodni”. Płatny dostęp do API przez Gemini Enterprise Agent Platform oraz licencje Code Assist Standard/Enterprise będą działać bez zmian.
Nie chodzi o „całkowite zamknięcie projektu”, lecz o zakończenie obsługi trzech najpopularniejszych planów. Oto kogo dotyczy zmiana: | Plan | Co oferował | Co stanie się 18 czerwca 2026 r. | |----|----|----| | Free tier | Dostęp do Gemini Code Assist i CLI z limitami | Całkowite wyłączenie | | Google AI Pro (około \$19.99/miesiąc) | Wyższe limity CLI i Code Assist | Całkowite wyłączenie | | Google AI Ultra (od \$100/miesiąc po I/O 2026) | Najwyższe limity | Całkowite wyłączenie | | Gemini Code Assist for GitHub | Automatyczne przeglądy PR w repozytorium przez Google | Brak nowych instalacji; istniejące zostaną wyłączone w kolejnych tygodniach | | Gemini Code Assist Standard / Enterprise (licencje firmowe) | Dostęp przez firmowe konto Google Workspace | Działa bez zmian | | Płatne API przez Google Cloud (płatny klucz Gemini API) | Żądania rozliczane w ramach projektu | Działa bez zmian | Z oficjalnego bloga Google Developers Blog:

18 czerwca 2026 r. Gemini CLI i rozszerzenia Gemini Code Assist IDE przestaną przetwarzać żądania użytkowników Google AI Pro, Ultra i Free tier.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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?
Najważniejsze informacje Gemini CLI było odrębnym eksperymentalnym projektem TypeScript/Node.js w repozytorium Google na GitHubie. Google zdecydowało o połączeniu wszystkich narzędzi agentowych w jednej platformie — Google Antigravity — z czterema interfejsami: Antigravity 2.0 (aplikacja komputerowa), Antigravity CLI (terminal), Antigravity SDK (opakowanie dla Pythona) i Antigravity IDE (fork VS Code). Antigravity CLI przepisano z Node.js na Go: uruchamia się w milisekundach zamiast setek milisekund i zużywa dziesiątki megabajtów pamięci zamiast setek.
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:

Antigravity CLI jest zbudowane w Go, działa szybciej i obsługuje asynchroniczne przepływy pracy w tle.

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

Repozytorium pozostanie dostępne na GitHubie na licencji Apache 2.0, a my będziemy kontynuować prace nad projektem jako oprogramowaniem open source.

— Google Developers Blog (Discussion #27274)
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
Najważniejsze informacje Instalator Google automatycznie wykrywa system operacyjny i architekturę, pobiera plik binarny i umieszcza go w `~/.local/bin` (Linux/macOS) lub `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Polecenia różnią się w zależności od systemu: na macOS i Linuxie używa się jednolinijkowego polecenia z `curl`, a na Windowsie PowerShell `irm` albo CMD. Po instalacji dodaj ścieżkę do `PATH`, jeśli instalator tego nie zrobił, otwórz nowy terminal i uruchom `agy doctor` — sprawdzi, czy znaleziono plik binarny i czy można połączyć się z Google.
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`: ```bash 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: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Sprawdź, czy plik binarny jest widoczny: ```bash which agy agy --version ``` ### Windows (PowerShell) ```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: ```cmd curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd ``` ### Sprawdź instalację Po instalacji w dowolnym systemie uruchom: ```bash 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
Najważniejsze informacje Antigravity CLI szuka konfiguracji w `.agents/` obok projektu oraz globalnie w `~/.agents/` — tak jak Gemini CLI szukało jej w `.gemini/`. Migrację wykonuje jedno polecenie `agy plugin import gemini`: przegląda ono `.gemini/extensions/`, migruje rozszerzenia jako wtyczki Antigravity i aktualizuje format konfiguracji. Folder skills przenieś ręcznie: `mv .gemini/skills/ .agents/skills/`. Następnie `agy doctor` i `agy inspect` pokażą, co zostało wykryte, czego brakuje i gdzie występują duplikaty.
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](https://ailoot.ai/blog/pl/agents-md-guide-template/), 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ć?
Najważniejsze informacje Jeśli skrypty CI/CD, GitHub Actions, lokalne pliki `.env` lub dotfiles przekazują `GEMINI_API_KEY` albo inne zmienne, trzeba zmienić ich nazwy. Prefiks `GEMINI_` zmienił się na `AV_` (od Antigravity). Antigravity CLI NIE odczyta starych zmiennych.
Pełna tabela zamienników: | Stara zmienna (Gemini CLI) | Nowa zmienna (Antigravity CLI) | Wartość domyślna | |----|----|----| | `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` | Oficjalny punkt końcowy Google | 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_`: ```bash # 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`: ```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 # should show “authorized” ``` ## Co najczęściej psuje się podczas przejścia i jak to naprawić
Najważniejsze informacje Według dyskusji na GitHubie najczęstsze problemy dotyczą serwerów MCP zdefiniowanych w `~/.gemini/config.json`, które nie są automatycznie przenoszone — konfigurację trzeba przepisać w formacie Antigravity. Własne hooks korzystające ze starych zmiennych środowiskowych zawodzą po cichu, więc testy kończą się niepowodzeniem bez czytelnego błędu. Skrypty, które bezpośrednio uzyskują dostęp do `.gemini/` zamiast korzystać z CLI, trzeba przełączyć na `.agents/`. Polecenie `@[file]` do wczytywania pliku do kontekstu miało błędy w początkowych kompilacjach Antigravity CLI; zostały one naprawione w nowszych wersjach, ale jeśli używasz starszej, zaktualizuj ją.
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](https://antigravity.google) (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?
Najważniejsze informacje Antigravity CLI uruchamia się szybciej, obsługuje Gemini 3.5 Flash oraz równoległych agentów i asynchroniczne zadania w tle przez `agy --background`. Są jednak dwa potencjalne problemy: regionalne ograniczenia dostępu i niedojrzały ekosystem (mniej wtyczek i serwerów MCP niż w Claude Code). Nie przenosiłbym się na Antigravity jako główne narzędzie. Używałbym go jako zapasowego kanału do równoległych zadań w tle, pozostawiając główne prace programistyczne w Claude Code. Jeśli korzystałeś z Gemini CLI w planie Free, 18 czerwca to dobry moment, by ponownie przemyśleć cały zestaw narzędzi.
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](https://ailoot.ai/blog/pl/google-antigravity/). Krótko: co zrobić w zależności od sytuacji: | Jeśli... | Co zrobić do 18 czerwca | |----|----| | Używałeś Free Gemini CLI do eksperymentów | Przenieś się na Antigravity CLI z kontem, które ma dostęp do usługi, LUB przejdź na Claude/Codex — zależnie od budżetu | | Korzystałeś z Gemini Code Assist w IDE | Przejdź na Antigravity IDE albo wróć do VS Code + Claude Code | | Uruchamiałeś nocne zadania cron przez Gemini API w planie Free | Pilnie przepisz je na płatne Cloud API (które nie zostanie wyłączone) LUB przenieś je do Claude API | | Korzystasz z firmowego Cloud (Standard/Enterprise) | Nie rób nic; wyłączenie Cię nie dotyczy | | Rozważałeś wypróbowanie Gemini CLI tylko dlatego, że „jest darmowe” | Nie zaczynaj; od razu przejdź na [Claude Code](https://ailoot.ai/blog/pl/claude-code/) lub [Codex](https://ailoot.ai/blog/pl/codex-vs-claude-code-choice/) | ## Lista migracyjna do wykonania w 15 minut
Najważniejsze informacje Jeśli chcesz przejść najszybszą drogę bez czytania całego przewodnika, wykonaj poniższą krótką sekwencję. W nowym terminalu, w którym nie działają żadne skrypty Gemini, cała migracja zajmie 10–20 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.
### Źródła - [Google Developers Blog - Ważna aktualizacja: przejście z Gemini CLI na Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Pierwsze kroki](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - repozytorium GitHub](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Najważniejsze informacje dla deweloperów z Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Kontynuuj pracę z AI na [Ailoot](https://ailoot.ai/).
## Pytania i odpowiedzi ### Jak sprawdzić zmienioną nazwę zmiennej klucza API bez ujawniania wartości? Sprawdź, czy `${AV_API_KEY:-}` jest niepuste, i wypisz tylko komunikat o ustawieniu lub braku. Nie wyświetlaj wartości klucza ani nie uruchamiaj sprawdzenia ze śledzeniem powłoki; uwierzytelnienie sprawdź osobno przez `agy doctor`. ### Czy udany import konfiguracji oznacza zakończenie migracji? Nie. Porównaj aktywne plugins, skills, hooks i subagents ze starą konfiguracją, sprawdź MCP i wykonaj małe zadanie. Zachowaj starą konfigurację `.gemini/`, aż sprawdzisz zamierzony sposób pracy i wynik. ## Ailoot · Firma i jej portfel projektów Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI. Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach. Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.