Migreren van Gemini CLI naar Antigravity CLI: een handleiding

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.

Wat werkt er precies niet meer op 18 juni 2026?#

Dit is geen “volledige sluiting van het project”, maar een stop voor de drie populairste abonnementen. Wie wordt er getroffen:

Uit de officiële Google Developers Blog:

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

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:

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:

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#

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:

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:

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

Controleer of het binarybestand zichtbaar is:

which agy
agy --version

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

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:

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#

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

Volledige vervangingstabel:

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:

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

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

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

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.

Een korte opsomming van wat je afhankelijk van je situatie kunt doen:

Migratiechecklist in 15 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.