Átállás a Gemini CLI-ről az Antigravity CLI-re: útmutató

2026. május 19-én a Google bejelentette, hogy június 18-án leállítja a régi Gemini CLI-t a Free, Pro és Ultra csomagok esetében. Két héttel az útmutató megjelenése után a gemini parancs leállítja a kérések feldolgozását. A Gemini CLI-ről az Antigravity CLI-re való átállás az agy paranccsal az egyetlen módja annak, hogy továbbra is a Google eszközeit használja. Az agy Go nyelven készült, és több tucatszor gyorsabban indul el.

Ha bármi fut a Gemini CLI-n — CI-szkriptek, éjszakai cronfeladatok, a Gemini Code Assist IDE-bővítmény —, ebből az útmutatóból megtudhatja, hogyan állhat át egyetlen este alatt anélkül, hogy bármit elrontana.

Pontosan mi fog leállni 2026. június 18-án?#

Ez nem „a projekt teljes leállítása”, hanem a három legnépszerűbb csomag megszüntetése. Kik érintettek:

A Google Developers Blog hivatalos közleményéből:

Ha a Free csomagot használta, ahogy az egyéni fejlesztők többsége, és arra gondol, hogy „de nekem fizetős fiókom van” — ellenőrizze pontosan, hogyan számlázzák az API-kulcsát. Az AI Pro nem Cloud-számlázás; ez egy személyes Google AI-előfizetés, és letiltják. A fizetős projekthez tartozó Cloud-számlázást nem tiltják le.

Miért állítja le egyáltalán a Google a Gemini CLI-t?#

A régi gemini „több száz milliszekundum” alatt indult, mert a Node.js-nek be kellett melegednie. Az új agy egyetlen statikus Go-binárisként készült, és „milliszekundumok” alatt indul. A különbség jelentős azoknál a CI-folyamatoknál és szkripteknél, amelyek futásonként több százszor hívják meg a CLI-t.

A Google szerint ez a sebesség és az oka:

A Gemini CLI összes fontos funkciója átkerült:

• Agent Skills — a .gemini/skills/ mappa most a .agents/skills/ mappában található.
• Hooks — ugyanazok az események (PreToolUse, PostToolUse stb.); a szintaxis alig változott.
• Subagents — a korábbiak szerint működnek, a konfigurációjuk pedig automatikusan átkerül.
• Extensions — Antigravity-bővítményekre nevezték át őket, és egyetlen paranccsal importálhatók.

Ami nem került át zökkenőmentesen: az MCP-szerverek és azok a régi szkriptek, amelyek közvetlenül érik el a .gemini/config.json fájlt. A GitHub-vitában egyes felhasználók arról számolnak be, hogy az MCP-konfigurációk elromlanak, és kézzel kell őket átírni. Erről alább külön rész szól.

A Google nem zárja be a Gemini CLI nyílt forráskódú projektjét:

Ez azt jelenti, hogy készíthet belőle forkot, és tovább használhatja a saját Gemini API-kulcsával. Ez azonban most már fizetős megoldás Cloud-számlázással; az ingyenes Code Assist-lehetőség megszűnik.

Az Antigravity CLI telepítése: parancsok macOS, Linux és Windows rendszerekhez#

Mielőtt nekilát, végezzen gyors önellenőrzést: melyik csomagot használja? Ha van fizetős Cloud-projektje, és nincs június 18-i határidő, az átállás hasznos, de nem sürgős. Ha a Free/Pro/Ultra csomagot használja, és fut valami a CLI-n, váltson most, amíg a csomagok még aktívak, így ugyanazon a feladaton hasonlíthatja össze a működést.

macOS és Linux

Egysoros parancs curl használatával:

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

A szkript felismeri a platformot, letölti az agy binárist, ellenőrzi az ellenőrzőösszegét, majd a ~/.local/bin mappába helyezi. Ha ez a mappa nincs benne a PATH-ban, adja hozzá:

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

Ellenőrizze, hogy a bináris elérhető-e:

which agy
agy --version

Windows (PowerShell)

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

A bináris a C:\Users\[your_name]\AppData\Local\agy\bin mappába kerül. A telepítő automatikusan frissíti a PATH-ot, de nyisson új PowerShell-ablakot a változók újratöltéséhez.

Windows (CMD)

Ha a vállalati szabályzat letiltja a PowerShellt:

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

A telepítés ellenőrzése

Bármelyik operációs rendszeren történő telepítés után futtassa ezt:

agy doctor

A parancs ellenőrzi a bináris verzióját, hogy létezik-e konfiguráció, az hitelesítést és az antigravity.google hálózati elérését. Ha nem tud kapcsolódni a Google-hoz, a problémát az Ön régiója vagy proxyja okozza.

Hitelesítés

Amikor először futtatja az agy parancsot argumentumok nélkül, elindul egy beállítási varázsló:

1. Válasszon felülettémát.
2. Válasszon hitelesítési módot: Google OAuth (személyes fiókokhoz) vagy API-kulcs.
3. Ha szeretné, azonnal importálja a konfigurációt a .gemini/ mappából.

Ha az OAuthot választja, megnyílik egy böngésző, amely átirányítja az accounts.google.com oldalra; hozzá kell járulnia az adatmegosztáshoz. Ezután működik a CLI.

Konfiguráció és bővítmények átállítása a .gemini mappából az .agents mappába#

Lépésről lépésre:

1. agy plugin import gemini

   Futtassa a parancsot bármelyik mappából. A globális bővítményeket a ~/.gemini/ mappából a ~/.agents/ mappába telepíti át. A munkaterület bővítményeihez (amelyek a projekt mellett találhatók) futtassa a parancsot a projektmappából.

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

   A skills mappa átnevezésével helyezze át kézzel a skills fájlokat. A bennük lévő fájlformátum azonos; nem kell újraírnia a Markdown-tartalmat.

3. agy inspect

   Megmutatja, mely bővítmények, skills, hooks és subagents aktívak. Hasonlítsa össze ezt azzal a listával, amelyet a Gemini CLI-ben használt — semminek sem szabad kimaradnia.

4. agy config --edit

   Megnyitja a konfigurációt az alapértelmezett szerkesztőben ($EDITOR). Ha valami nem került át automatikusan, szerkessze kézzel.

5. agy doctor

   Végső ellenőrzés: bináris, hitelesítés, bővítmények, hálózat. Ha mind a négy rendben van, a konfiguráció átállítása befejeződött.

Hagyja a régi .gemini/ mappát a helyén biztonsági másolatként egy hónapig arra az esetre, ha valami kimaradt. Miután egy hétig használta az Antigravityt, és meggyőződött róla, hogy minden megvan, törölheti.

Ha az AGENTS.md fájlt univerzális konfigurációként használja az összes AI-eszközhöz, nincs vele teendője. Az Antigravity CLI ugyanabból a mappából olvassa be az AGENTS.md fájlt, mint a Claude Code vagy a Codex.

Mely környezeti változókat kell módosítani?#

A teljes csere táblázata:

Ha a GitHub Actions secrets értékeit továbbadja, nyissa meg a Settings -> Secrets -> Actions oldalt, és nevezze át a kulcsokat. Maguk az értékek változatlanok maradnak (a Google API-kulcs nem változott az átállás során).

Ellenőrizzen minden helyet, ahol GEMINI_ szerepelhet:

# Keresse meg az előfordulásokat a projektben
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# A dotfile-okban
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

A változók átnevezése után indítsa újra a terminált, és az érték kiírása nélkül ellenőrizze a jelenlétüket. Ne kapcsolja be a shell-nyomkövetést, és a kulcsértékeket ne másolja naplókba. A jelenlét önmagában nem bizonyít jogosultságot; az agy doctor eredményét külön vizsgálja meg:

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        # az „authorized” állapotot kell mutatnia

Mi hibásodik meg leggyakrabban az átállás során, és hogyan javíthatja ki?#

A kezdeti problémák ellenőrzőlistája:

1. MCP-szerverek. Ha a mcp_servers beállítást használta a .gemini/config.json fájlban, előfordulhat, hogy a szerverek nem kerülnek át az agy plugin import gemini futtatása után. Ellenőrizze az agy inspect paranccsal — lesz benne egy mcp szakasz. Ha üres vagy hibákat jelez, írja át kézzel az agy config --edit paranccsal. A formátumot az Antigravity hivatalos dokumentációja ismerteti (keresse meg az MCP-ről szóló részt).

2. Egyéni hookok. Ha volt olyan bash-szkriptje a .gemini/hooks/ mappában, amely a $GEMINI_API_KEY változót olvasta, az el fog romlani. Keresse meg az ilyen helyeket: bash

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

   Cserélje le a változókat.

3. CI/CD. A GitHub Actionsben vagy a GitLab CI-ban cserélje le a gemini parancsot használó lépéseket agy parancsra. A telepítőben szereplő bináris neve eltérhet, ezért hozzon létre absztrakciót a $CLI_CMD változó használatával.

4. IDE-bővítmény. A Gemini Code Assist VS Code-bővítményét a CLI-vel együtt letiltják. Helyette használhatja az Antigravity IDE-t (különálló VS Code-fork), vagy az AGENTS.md fájlt bármely más AI-szerkesztőben.

5. @[file] fájlbetöltés. Az Antigravity CLI korai buildjeiben az @src/file.ts paranccsal történő, kontextusba való fájlbetöltés hibás volt. Frissítsen a legújabb verzióra: agy update.

Ha valami kritikus dolog elromlik, és egy órán belül nem javítható, átmeneti megoldásként a Free csomag felhasználói június 18-ig a Gemini CLI-n maradhatnak, miközben egy külön adattárágon előkészítik az átállást. Határidő: 14 nap.

Érdemes június 18. után is a Google eszközeit használni?#

Az Antigravity 2.0 tartalék lehetőségként jöhet szóba olyan esetekre, amikor az elsődleges eszköze (Claude Code vagy Codex) nem megfelelő. A részletes áttekintésért arról, hogy miben jó és miben gyenge, olvassa el a Google Antigravity 2.0-ról szóló útmutatót.

Röviden összefoglalva, hogy az Ön helyzetétől függően mit érdemes tennie:

Átállási ellenőrzőlista 15 perc alatt#

1. Telepítse az Antigravity CLI-t

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

2. Indítsa el az agy-t, és hitelesítse magát

   Argumentumok nélkül: agy. Válassza az OAuthot vagy egy API-kulcsot.

3. Importálja a bővítményeket a .gemini mappából

   agy plugin import gemini — ez globálisan áttelepíti a bővítményeket. A munkaterület bővítményeihez futtassa újra a projektmappában.

4. Helyezze át a skills mappát

   mv .gemini/skills/ .agents/skills/. A fájlok tartalma változatlan marad.

5. Cserélje le a környezeti változókat

   A ~/.zshrc/~/.bashrc és .env fájlokban: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Indítsa újra a terminált.

6. Ellenőrizze a telepítést

   agy doctor — mind a négy elemnek (bináris, hitelesítés, bővítmények, hálózat) zöldnek kell lennie.

7. Futtasson egy tesztfeladatot

   agy "write a README for the project in the current folder" — ellenőrizze, hogy az eredmény hasonló-e ahhoz, amit a Gemini CLI adott.

8. Frissítse a GitHub Actions / GitLab CI beállításait

   Cserélje le a parancs nevét, valamint a secrets változókat GEMINI_*-ről AV_*-ra.

9. Tartsa meg a .gemini/ mappát biztonsági másolatként

   1–2 héttel azután törölheti, hogy meggyőződött arról, hogy minden működik.

Végül: június 18. nem jelenti azt, hogy „minden projektje leáll”. Azt jelenti, hogy az ingyenes hozzáférési csatornát letiltják. A fizetős Cloud API-hozzáférés megmarad, a Gemini CLI-adattár megmarad, és forkok is készíthetők. Ha a Free csomagot használta, június 18. előtt döntenie kell; különben a következő gemini "something" parancs hitelesítési hibát ad vissza.