# Migreren van Gemini CLI naar Antigravity CLI: een handleiding > agy installeren, configuratie, plugins en omgevingsvariabelen migreren; controles, veelvoorkomende fouten en regionale beperkingen. Source: https://ailoot.ai/blog/nl/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/nl/gemini-cli-to-antigravity-cli-migration/ Language: nl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-0cf890354d1f920819aeb7e50460a3e51ced10bd12a75cdece4a7eec187f890c Op 19 mei 2026 kondigde Google aan dat het de oude Gemini CLI voor alle Free-, Pro- en Ultra-abonnementen op 18 juni zou uitschakelen. Twee weken nadat deze handleiding is gepubliceerd, stopt de opdracht `gemini` met het verwerken van verzoeken. Migreren van Gemini CLI naar Antigravity CLI met de opdracht `agy` is de enige manier om Google-tools te blijven gebruiken. `agy` is in Go gebouwd en start tientallen keren sneller. Als er iets op Gemini CLI draait — CI-scripts, nachtelijke cron-taken of de Gemini Code Assist IDE-extensie — legt deze handleiding uit hoe je in één avond migreert zonder iets kapot te maken.
Het verbinden van modellen en werken met de API worden behandeld in de [Ailoot-documentatie](https://ailoot.ai/docs/).
## Wat werkt er precies niet meer op 18 juni 2026?
Belangrijkste conclusie Op 18 juni 2026 stoppen Gemini CLI en de Gemini Code Assist-extensie voor VS Code met het verwerken van verzoeken voor drie categorieën gebruikers: het Free-abonnement, Google AI Pro en Google AI Ultra. Nieuwe installaties van Gemini Code Assist op GitHub zijn niet langer beschikbaar; bestaande installaties worden “in de komende weken” uitgeschakeld. Betaalde API-toegang via Gemini Enterprise Agent Platform en Code Assist Standard/Enterprise-licenties blijft ongewijzigd werken.
Dit is geen “volledige sluiting van het project”, maar een stop voor de drie populairste abonnementen. Wie wordt er getroffen: | Abonnement | Wat het bood | Wat er op 18 juni 2026 gebeurt | |----|----|----| | Free-abonnement | Toegang tot Gemini Code Assist + CLI met limieten | Volledig uitgeschakeld | | Google AI Pro (ongeveer \$19.99/maand) | Hogere limieten voor CLI en Code Assist | Volledig uitgeschakeld | | Google AI Ultra (vanaf \$100/maand na I/O 2026) | De hoogste limieten | Volledig uitgeschakeld | | Gemini Code Assist voor GitHub | Google's automatische PR-beoordelingen in je repository | Geen nieuwe installaties; bestaande worden in de komende weken uitgeschakeld | | Gemini Code Assist Standard / Enterprise (bedrijfslicenties) | Via een zakelijk Google Workspace-account | Blijft ongewijzigd werken | | Betaalde API via Google Cloud (betaalde Gemini API-sleutel) | Verzoeken die aan het project in rekening worden gebracht | Blijft ongewijzigd werken | Uit de officiële Google Developers Blog:

Op 18 juni 2026 stoppen Gemini CLI en Gemini Code Assist IDE-extensies met het verwerken van verzoeken voor gebruikers van Google AI Pro, Ultra en het Free-abonnement.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Als je het Free-abonnement gebruikte, zoals de meeste individuele ontwikkelaars, en denkt “maar ik heb een betaald account” — controleer dan precies hoe je API-sleutel wordt gefactureerd. AI Pro is geen Cloud-facturering; het is een persoonlijk Google AI-abonnement en dat wordt uitgeschakeld. Cloud-facturering met een betaald project wordt niet uitgeschakeld. ## Waarom stopt Google überhaupt met Gemini CLI?
Belangrijkste conclusie Gemini CLI was een afzonderlijk TypeScript/Node.js-experiment in Googles GitHub-repository. Google besloot al zijn agenttools samen te brengen onder één platform — Google Antigravity — met vier interfaces: Antigravity 2.0 (desktopapplicatie), Antigravity CLI (terminal), Antigravity SDK (Python-wrapper) en Antigravity IDE (VS Code-fork). Antigravity CLI is opnieuw gebouwd van Node.js naar Go: het start in milliseconden in plaats van honderden milliseconden en gebruikt tientallen megabytes geheugen in plaats van honderden.
De oude `gemini` startte in “honderden milliseconden” omdat Node.js moest opwarmen. De nieuwe `agy` is gebouwd als één statisch Go-binarybestand en start in “milliseconden”. Voor CI en scripts die de CLI honderden keren per uitvoering aanroepen, is het verschil aanzienlijk. Wat Google zegt over de snelheid en de reden:

Antigravity CLI is in Go gebouwd, werkt sneller en ondersteunt asynchrone achtergrondworkflows.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Alle belangrijke functies van Gemini CLI zijn overgezet: - **Agent Skills** — de map `.gemini/skills/` staat nu in `.agents/skills/`. - **Hooks** — dezelfde gebeurtenissen (`PreToolUse`, `PostToolUse`, enz.); de syntaxis is nauwelijks veranderd. - **Subagents** — werken zoals voorheen en hun configuratie wordt automatisch gemigreerd. - **Extensions** — hernoemd naar Antigravity-plugins en met één opdracht geïmporteerd. Wat niet naadloos is gemigreerd: MCP-servers en oude scripts die rechtstreeks toegang hebben tot `.gemini/config.json`. Volgens de GitHub-discussie melden sommige gebruikers dat MCP-configuraties niet meer werken en handmatig moeten worden herschreven. Hieronder staat hiervoor een apart gedeelte. Google sluit het open-sourceproject Gemini CLI niet:

De repository blijft beschikbaar op GitHub onder de Apache 2.0-licentie, en we blijven aan het project werken als open source.

— Google Developers Blog (Discussion #27274)
Dat betekent dat je het kunt forken en met je eigen Gemini API-sleutel kunt blijven gebruiken. Dit is nu echter een betaalde configuratie via Cloud-facturering; de gratis Code Assist-regeling is voorbij. ## Antigravity CLI installeren: opdrachten voor macOS, Linux en Windows
Belangrijkste conclusie Het installatieprogramma van Google detecteert automatisch het besturingssysteem en de architectuur, downloadt het binarybestand en plaatst het in `~/.local/bin` (Linux/macOS) of `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). De opdrachten verschillen per besturingssysteem: op macOS en Linux één regel met `curl`; op Windows PowerShell `irm` of de CMD-optie. Voeg na de installatie het pad toe aan `PATH` als het installatieprogramma dat niet heeft gedaan, open een nieuwe terminal en voer `agy doctor` uit — hiermee wordt gecontroleerd of het binarybestand is gevonden en Google kan bereiken.
Doe voordat je begint een snelle zelfcontrole: welk abonnement heb je? Als je een betaald Cloud-project hebt zonder deadline op 18 juni, is migreren nuttig maar niet dringend. Als je Free/Pro/Ultra gebruikt en er iets op de CLI draait, stap dan nu over terwijl de abonnementen nog actief zijn, zodat je het gedrag voor dezelfde taak kunt vergelijken. ### macOS en Linux Eén regel met `curl`: ```bash curl -fsSL https://antigravity.google/cli/install.sh | bash ``` Het script detecteert het platform, downloadt het `agy`-binarybestand, controleert de checksum en plaatst het in `~/.local/bin`. Als deze map niet in `PATH` staat, voeg hem dan toe: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Controleer of het binarybestand zichtbaar is: ```bash which agy agy --version ``` ### Windows (PowerShell) ```powershell irm https://antigravity.google/cli/install.ps1 | iex ``` Het binarybestand wordt geïnstalleerd in `C:\Users\[your_name]\AppData\Local\agy\bin`. Het installatieprogramma werkt `PATH` automatisch bij, maar open een nieuw PowerShell-venster om de variabelen opnieuw te laden. ### Windows (CMD) Als PowerShell door je bedrijfsbeleid wordt geblokkeerd: ```cmd curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd ``` ### De installatie controleren Voer na de installatie op elk besturingssysteem het volgende uit: ```bash agy doctor ``` De opdracht controleert de versie van het binarybestand, of er configuratie bestaat, de authenticatie en de netwerktoegang tot `antigravity.google`. Als de verbinding met Google niet lukt, ligt het probleem bij je regio of proxy. ### Authenticatie De eerste keer dat je `agy` zonder argumenten uitvoert, wordt een installatiewizard gestart: 1. Kies een interfacethema. 2. Kies een authenticatiemethode: Google OAuth (voor persoonlijke accounts) of een API-sleutel. 3. Importeer eventueel meteen de configuratie uit `.gemini/`. Als je OAuth kiest, wordt een browser geopend en word je doorgestuurd naar `accounts.google.com`; je moet toestemming geven voor het delen van gegevens. Daarna werkt de CLI. ## Configuratie en plugins migreren van .gemini naar .agents
Belangrijkste conclusie Antigravity CLI zoekt de configuratie in `.agents/` naast het project en globaal in `~/.agents/` — net zoals Gemini CLI in `.gemini/` zocht. Migreren doe je met één opdracht, `agy plugin import gemini`: deze doorloopt `.gemini/extensions/`, migreert de extensies als Antigravity-plugins en werkt de configuratie-indeling bij. Verplaats de map met skills handmatig: `mv .gemini/skills/ .agents/skills/`. Daarna laten `agy doctor` en `agy inspect` zien wat is gevonden, wat niet is gevonden en waar er duplicaten zijn.
Stap voor stap: 1. ### agy plugin import gemini Voer de opdracht uit vanuit een willekeurige map. Hiermee worden globale plugins gemigreerd van `~/.gemini/` naar `~/.agents/`. Voer de opdracht vanuit de projectmap uit voor workspace-plugins (naast het project). 2. ### mv .gemini/skills/ .agents/skills/ Verplaats skills door de map handmatig te hernoemen. De bestandsindeling erin is hetzelfde; de Markdown hoeft niet te worden herschreven. 3. ### agy inspect Toont welke plugins, skills, hooks en subagents actief zijn. Vergelijk dit met de lijst die je in Gemini CLI had — er mogen geen items ontbreken. 4. ### agy config --edit Opent de configuratie in de standaardeditor (`$EDITOR`). Als iets niet automatisch is opgepakt, bewerk het dan handmatig. 5. ### agy doctor Laatste controle: binarybestand, authenticatie, plugins en netwerk. Als ze alle vier groen zijn, is de configuratiemigratie voltooid. Ik zou de oude map `.gemini/` een maand laten staan als back-up, voor het geval er iets ontbreekt. Nadat je Antigravity een week hebt gebruikt en hebt gecontroleerd of alles aanwezig is, kun je de map verwijderen. Als je [AGENTS.md als universele configuratie voor alle AI-tools](https://ailoot.ai/blog/nl/agents-md-guide-template/) gebruikt, hoef je daar niets aan te doen. Antigravity CLI leest `AGENTS.md` uit dezelfde map als Claude Code of Codex. ## Welke omgevingsvariabelen moeten worden gewijzigd?
Belangrijkste conclusie Als je CI/CD-scripts, GitHub Actions, lokale `.env`-bestanden of dotfiles hebt die `GEMINI_API_KEY` of andere variabelen doorgeven, moet je de namen aanpassen. Het voorvoegsel `GEMINI_` is veranderd in `AV_` (voor Antigravity). Antigravity CLI leest de oude variabelen NIET.
Volledige vervangingstabel: | Oude variabele (Gemini CLI) | Nieuwe variabele (Antigravity CLI) | Standaardwaarde | |----|----|----| | `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` | Officieel Google-eindpunt | Als je GitHub Actions hebt die secrets doorgeven, open dan `Settings -> Secrets -> Actions` en hernoem de sleutels. De waarden zelf blijven hetzelfde (de Google API-sleutel is tijdens de migratie niet veranderd). Controleer alle plaatsen waar `GEMINI_` kan staan: ```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 ``` Start na het vervangen de terminal opnieuw en controleer aanwezigheid zonder het geheim af te drukken. Schakel shelltracing niet in en kopieer geen sleutelwaarden naar logs. Aanwezigheid alleen bewijst geen autorisatie; bekijk `agy doctor` afzonderlijk: ```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” ``` ## Wat gaat er tijdens de overgang het vaakst mis en hoe los je het op?
Belangrijkste conclusie Volgens de GitHub-discussie zijn de meest voorkomende problemen MCP-servers die zijn gedefinieerd in `~/.gemini/config.json` en niet automatisch worden overgenomen — de configuratie moet worden herschreven in Antigravity-indeling. Aangepaste hooks die oude omgevingsvariabelen gebruiken, mislukken stilzwijgend, waardoor tests falen zonder duidelijke foutmelding. Scripts die rechtstreeks toegang hebben tot `.gemini/` (in plaats van via de CLI) moeten worden aangepast naar `.agents/`. De opdracht `@[file]` om een bestand in de context te laden bevatte bugs toen Antigravity CLI voor het eerst werd uitgebracht; die zijn in recente builds verholpen, maar als je een oudere versie gebruikt, werk die dan bij.
Checklist met aanvankelijke problemen: 1. **MCP-servers.** Als je `mcp_servers` in `.gemini/config.json` gebruikte, worden ze mogelijk niet overgenomen na `agy plugin import gemini`. Controleer dit met `agy inspect` — daar staat een `mcp`-sectie. Als die leeg is of fouten bevat, herschrijf de configuratie dan handmatig met `agy config --edit`. De indeling staat beschreven in de officiële Antigravity-documentatie (zoek naar het MCP-gedeelte). 2. **Aangepaste hooks.** Als je een bash-script in `.gemini/hooks/` had dat `$GEMINI_API_KEY` las, werkt het niet meer. Zoek zulke plaatsen op: bash ``` grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null ``` Vervang de variabelen. 3. **CI/CD.** Wijzig in GitHub Actions of GitLab CI de stappen die de opdracht `gemini` gebruiken naar `agy`. De naam van het binarybestand in het installatieprogramma kan verschillen, dus maak een abstractie met de variabele `$CLI_CMD`. 4. **IDE-extensie.** De Gemini Code Assist-extensie voor VS Code wordt samen met de CLI uitgeschakeld. De vervanging is [Antigravity IDE](https://antigravity.google) (een afzonderlijke VS Code-fork) of AGENTS.md in een andere AI-editor. 5. **`@[file]` laden.** In vroege builds van Antigravity CLI bevatte de opdracht `@src/file.ts` om een bestand in de context te laden bugs. Werk bij naar de nieuwste versie: `agy update`. Als er iets essentieels kapotgaat en het niet binnen een uur kan worden opgelost, is een tijdelijke oplossing voor het Free-abonnement om Gemini CLI tot 18 juni te blijven gebruiken terwijl je de migratie op een afzonderlijke repositorybranch configureert. Tijdslimiet: 14 dagen. ## Is het de moeite waard om na 18 juni Google-tools te blijven gebruiken?
Belangrijkste conclusie Antigravity CLI start sneller, werkt met Gemini 3.5 Flash en ondersteunt parallelle agents en asynchrone achtergrondtaken via `agy --background`. Maar er zijn twee mogelijke problemen: regionale toegangsbeperkingen en een onvolwassen ecosysteem (minder plugins en MCP-servers dan Claude Code). Ik zou niet naar Antigravity migreren als mijn primaire tool. Ik zou het gebruiken als back-upkanaal voor parallelle achtergrondtaken en het belangrijkste ontwikkelwerk in Claude Code houden. Als je Gemini CLI voor het Free-abonnement gebruikte, is 18 juni een geschikt moment om je hele toolset opnieuw te bekijken.
Antigravity 2.0 kan worden beschouwd als back-upoptie voor situaties waarin je primaire tool (Claude Code of Codex) niet geschikt is. Lees voor een gedetailleerd overzicht van de sterke en zwakke punten de [handleiding voor Google Antigravity 2.0](https://ailoot.ai/blog/nl/google-antigravity/). Een korte opsomming van wat je afhankelijk van je situatie kunt doen: | Als je... | Wat je vóór 18 juni moet doen | |----|----| | Gemini CLI met het Free-abonnement gebruikte voor experimenten | Migreer naar Antigravity CLI met een account dat toegang tot de service heeft OF stap over naar Claude/Codex — afhankelijk van je budget | | Gemini Code Assist in je IDE gebruikte | Stap over naar Antigravity IDE of ga terug naar VS Code + Claude Code | | Nachtelijke cron-taken via Gemini API op het Free-abonnement uitvoerde | Herschrijf ze dringend voor de betaalde Cloud API (die niet wordt uitgeschakeld) OF verplaats ze naar Claude API | | Via zakelijke Cloud (Standard/Enterprise) werkt | Doe niets; de stopzetting heeft geen gevolgen voor je | | Van plan was Gemini CLI te proberen omdat “het gratis is” | Begin er niet aan; gebruik direct [Claude Code](https://ailoot.ai/blog/nl/claude-code/) of [Codex](https://ailoot.ai/blog/nl/codex-vs-claude-code-choice/) | ## Migratiechecklist in 15 minuten
Belangrijkste conclusie Als je de snelste route wilt zonder de hele handleiding te lezen, volgt hier de korte volgorde. In een nieuwe terminal zonder actieve Gemini-scripts duurt de hele migratie 10–20 minuten.
1. ### Installeer Antigravity CLI `curl -fsSL https://antigravity.google/cli/install.sh | bash` (macOS/Linux) of `irm https://antigravity.google/cli/install.ps1 | iex` (Windows PowerShell). 2. ### Start agy en authenticeer Zonder argumenten: `agy`. Kies OAuth of een API-sleutel. 3. ### Importeer plugins uit .gemini `agy plugin import gemini` — hiermee worden extensies globaal gemigreerd. Voer de opdracht opnieuw uit in de projectmap voor workspace-plugins. 4. ### Verplaats skills `mv .gemini/skills/ .agents/skills/`. De bestandsinhoud blijft hetzelfde. 5. ### Vervang omgevingsvariabelen In `~/.zshrc`/`~/.bashrc` en `.env`-bestanden: `GEMINI_API_KEY → AV_API_KEY`, `GEMINI_PROJECT_ID → AV_PROJECT_ID`, `GEMINI_REGION → AV_REGION`. Start de terminal opnieuw. 6. ### Controleer de installatie `agy doctor` — alle vier de onderdelen (binarybestand, authenticatie, plugins, netwerk) moeten groen zijn. 7. ### Voer een testtaak uit `agy "write a README for the project in the current folder"` — controleer of het resultaat vergelijkbaar is met wat Gemini CLI produceerde. 8. ### Werk GitHub Actions / GitLab CI bij Wijzig de opdrachtnaam en secrets van `GEMINI_*` naar `AV_*`. 9. ### Bewaar .gemini/ als back-up Je kunt de map 1–2 weken nadat je hebt bevestigd dat alles werkt verwijderen. En tot slot: 18 juni betekent niet dat “al je projecten uitvallen”. Het betekent dat het gratis kanaal wordt uitgeschakeld. Betaalde Cloud API-toegang blijft beschikbaar, de Gemini CLI-repository blijft bestaan en forken blijft mogelijk. Als je het Free-abonnement gebruikte, moet je vóór 18 juni een beslissing nemen; anders geeft de volgende opdracht `gemini "something"` een autorisatiefout.
### Bronnen - [Google Developers Blog - Een belangrijke update: overstappen van Gemini CLI naar Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Aan de slag](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - GitHub-repository](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Hoogtepunten voor ontwikkelaars van Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Blijf met AI werken op [Ailoot](https://ailoot.ai/).
## Vragen en antwoorden ### Hoe controleer ik de hernoemde API-sleutelvariabele zonder die bloot te stellen? Test of ${AV_API_KEY:-} niet leeg is en druk alleen een bericht over aanwezigheid of ontbreken af. Toon de sleutelwaarde niet met echo en voer de controle niet uit met shelltracing ingeschakeld; gebruik agy doctor afzonderlijk om de authenticatie te bekijken. ### Bewijst een geslaagde configuratie-import dat de migratie klaar is? Nee. Vergelijk actieve plugins, skills, hooks en subagents met de oude configuratie, bekijk de MCP-instellingen en voer een kleine taak uit. Bewaar de oude .gemini/-configuratie totdat de bedoelde workflow en het resultaat zijn gecontroleerd. ## Ailoot · Het bedrijf en zijn projectenportefeuille Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle. Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden. Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.