Migrering fra Gemini CLI til Antigravity CLI: en vejledning

Den 19. maj 2026 meddelte Google, at de ville lukke den gamle Gemini CLI for alle Free-, Pro- og Ultra-abonnementer den 18. juni. To uger efter udgivelsen af denne vejledning holder kommandoen gemini op med at behandle anmodninger. Migrering fra Gemini CLI til Antigravity CLI med kommandoen agy er den eneste måde at fortsætte med Googles værktøjer på. agy er bygget i Go og starter snesevis af gange hurtigere.

Hvis du har noget kørende på Gemini CLI – CI-scripts, natlige cron-jobs eller Gemini Code Assist IDE-udvidelsen – forklarer denne vejledning, hvordan du migrerer på en aften uden at ødelægge noget.

Hvad holder præcist op med at fungere den 18. juni 2026?#

Dette er ikke en ”fuldstændig lukning af projektet”, men et stop for de tre mest populære abonnementer. Hvem bliver berørt:

Fra den officielle Google Developers Blog:

Hvis du brugte Free-abonnementet, ligesom de fleste individuelle udviklere, og tænker ”men jeg har en betalt konto” – så kontrollér præcis, hvordan din API-nøgle faktureres. AI Pro er ikke Cloud-fakturering; det er et personligt Google AI-abonnement, og det bliver deaktiveret. Cloud-fakturering med et betalt projekt bliver ikke deaktiveret.

Hvorfor lukker Google overhovedet Gemini CLI?#

Den gamle gemini startede på ”hundredvis af millisekunder”, fordi Node.js skulle varmes op. Den nye agy er bygget som én statisk Go-binærfil og starter på ”millisekunder”. For CI og scripts, der kalder CLI hundredvis af gange pr. kørsel, er forskellen betydelig.

Dette siger Google om hastigheden og årsagen:

Alle de vigtigste funktioner fra Gemini CLI er flyttet over:

• Agent Skills — mappen .gemini/skills/ findes nu i .agents/skills/.
• Hooks — de samme hændelser (PreToolUse, PostToolUse osv.); syntaksen er næsten ikke ændret.
• Subagents — fungerer som før, og deres konfiguration migreres automatisk.
• Extensions — omdøbt til Antigravity-plugins og importeres med én kommando.

Det, der IKKE blev migreret problemfrit: MCP-servere og gamle scripts, der tilgår .gemini/config.json direkte. Ifølge GitHub-diskussionen rapporterer nogle brugere, at MCP-konfigurationer går i stykker og skal omskrives manuelt. Der er et særskilt afsnit om dette nedenfor.

Google lukker ikke Gemini CLI-projektet med åben kildekode:

Det betyder, at du kan forke det og fortsætte med at bruge det med din egen Gemini API-nøgle. Men det bliver nu en betalt opsætning via Cloud-fakturering; den gratis Code Assist-ordning ophører.

Sådan installerer du Antigravity CLI: kommandoer til macOS, Linux og Windows#

Lav en hurtig selvkontrol, før du går i gang: Hvilket abonnement har du? Hvis du har et betalt Cloud-projekt uden en deadline den 18. juni, er migrering nyttig, men ikke presserende. Hvis du har Free/Pro/Ultra og noget kører via CLI, så skift nu, mens abonnementerne stadig er aktive, så du kan sammenligne adfærden for den samme opgave.

macOS og Linux

En enkelt linje med curl:

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

Scriptet registrerer platformen, downloader agy-binærfilen, kontrollerer dens kontrolsum og placerer den i ~/.local/bin. Hvis denne mappe ikke er i PATH, skal du tilføje den:

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

Kontrollér, at binærfilen er synlig:

which agy
agy --version

Windows (PowerShell)

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

Binærfilen installeres i C:\Users\[your_name]\AppData\Local\agy\bin. Installationsprogrammet opdaterer PATH automatisk, men åbn et nyt PowerShell-vindue for at genindlæse variablerne.

Windows (CMD)

Hvis PowerShell er blokeret af virksomhedens politik:

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

Kontrollér installationen

Kør følgende efter installationen på et hvilket som helst operativsystem:

agy doctor

Kommandoen kontrollerer binærversionen, om der findes en konfiguration, godkendelse og netværksadgang til antigravity.google. Hvis den ikke kan nå Google, skyldes problemet din region eller proxy.

Godkendelse

Første gang du kører agy uden argumenter, starter en opsætningsguide:

1. Vælg et tema til grænsefladen.
2. Vælg en godkendelsesmetode: Google OAuth (til personlige konti) eller en API-nøgle.
3. Du kan eventuelt importere konfigurationen fra .gemini/ med det samme.

Hvis du vælger OAuth, åbnes en browser, der omdirigerer dig til accounts.google.com; du skal give samtykke til datadeling. Derefter virker CLI.

Sådan migrerer du konfiguration og plugins fra .gemini til .agents#

Trin for trin:

1. agy plugin import gemini

   Kør kommandoen fra en hvilken som helst mappe. Den migrerer globale plugins fra ~/.gemini/ til ~/.agents/. For workspace-plugins (ved siden af projektet) skal du køre kommandoen i projektmappen.

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

   Flyt skills ved manuelt at omdøbe mappen. Filformatet er det samme; du behøver ikke omskrive markdown-filerne.

3. agy inspect

   Viser, hvilke plugins, skills, hooks og subagents der er aktive. Sammenlign med listen fra Gemini CLI – der bør ikke mangle noget.

4. agy config --edit

   Åbner konfigurationen i standardeditoren ($EDITOR). Redigér manuelt det, der ikke blev hentet automatisk.

5. agy doctor

   Afsluttende kontrol: binærfil, godkendelse, plugins, netværk. Hvis alle fire er grønne, er konfigurationsmigreringen færdig.

Jeg ville lade den gamle .gemini/-mappe blive liggende som sikkerhedskopi i en måned, hvis der er noget, du har overset. Når du har brugt Antigravity i en uge og bekræftet, at alt er der, kan du slette den.

Hvis du arbejder med AGENTS.md som universel konfiguration til alle AI-værktøjer, behøver du ikke ændre den. Antigravity CLI læser AGENTS.md fra samme mappe som Claude Code eller Codex.

Hvilke miljøvariabler skal ændres?#

Komplet tabel over erstatninger:

Hvis du har GitHub Actions, der sender secrets videre, skal du åbne Settings -> Secrets -> Actions og omdøbe nøglerne. Selve værdierne forbliver de samme (Googles API-nøgle ændrede sig ikke under migreringen).

Kontrollér alle steder, der kan indeholde GEMINI_:

# Find omtaler i hele projektet
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

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

Genstart terminalen efter udskiftningen, og kontrollér tilstedeværelsen uden at udskrive hemmeligheden. Slå ikke shellsporing til, og kopiér ikke nøgleværdier til logs. Tilstedeværelse alene beviser ikke godkendelse; undersøg agy doctor særskilt:

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”

Hvad går oftest galt under overgangen, og hvordan løser man det?#

Tjekliste over indledende problemer:

1. MCP-servere. Hvis du brugte mcp_servers i .gemini/config.json, bliver de muligvis ikke hentet efter agy plugin import gemini. Kontrollér med agy inspect – der vil være et mcp-afsnit. Hvis det er tomt eller indeholder fejl, skal du omskrive det manuelt med agy config --edit. Formatet er beskrevet i den officielle Antigravity-dokumentation (se efter MCP-afsnittet).

2. Brugerdefinerede hooks. Hvis du havde et bash-script i .gemini/hooks/, der læste $GEMINI_API_KEY, holder det op med at fungere. Find sådanne steder: bash

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

   Erstat variablerne.

3. CI/CD. I GitHub Actions eller GitLab CI skal du ændre trin, der bruger kommandoen gemini, til agy. Binærnavnet i installationsprogrammet kan variere, så opret en abstraktion ved hjælp af variablen $CLI_CMD.

4. IDE-udvidelse. Gemini Code Assist-udvidelsen til VS Code deaktiveres sammen med CLI. Erstatningen er Antigravity IDE (en separat VS Code-fork) eller AGENTS.md i en hvilken som helst anden AI-editor.

5. Indlæsning med @[file]. I de tidlige Antigravity CLI-versioner havde kommandoen @src/file.ts til at indlæse en fil i konteksten fejl. Opdatér til den nyeste version: agy update.

Hvis noget kritisk går i stykker og ikke kan repareres inden for en time, er en midlertidig løsning for Free-abonnementet at blive på Gemini CLI indtil den 18. juni, mens du sætter migreringen op på en separat gren i repositoryet. Tidsgrænse: 14 dage.

Er det værd at blive hos Googles værktøjer efter den 18. juni?#

Antigravity 2.0 kan betragtes som en reservemulighed i tilfælde, hvor dit primære værktøj (Claude Code eller Codex) ikke egner sig. Se vejledningen til Google Antigravity 2.0 for en detaljeret gennemgang af, hvad det er godt og dårligt til.

En kort oversigt over, hvad du bør gøre afhængigt af din situation:

Migreringstjekliste på 15 minutter#

1. Installér Antigravity CLI

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

2. Start agy, og godkend

   Uden argumenter: agy. Vælg OAuth eller en API-nøgle.

3. Importér plugins fra .gemini

   agy plugin import gemini—dette migrerer udvidelser globalt. Kør kommandoen igen i projektmappen for workspace-plugins.

4. Flyt skills

   mv .gemini/skills/ .agents/skills/. Filindholdet forbliver uændret.

5. Erstat miljøvariabler

   I ~/.zshrc/~/.bashrc og .env-filer: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Genstart terminalen.

6. Kontrollér installationen

   agy doctor – alle fire punkter (binærfil, godkendelse, plugins, netværk) skal være grønne.

7. Kør en testopgave

   agy "write a README for the project in the current folder" – kontrollér, at resultatet ligner det, Gemini CLI leverede.

8. Opdatér GitHub Actions / GitLab CI

   Skift kommandonavn og secrets fra GEMINI_* til AV_*.

9. Behold .gemini/ som sikkerhedskopi

   Du kan slette den 1–2 uger efter at have bekræftet, at alt fungerer.

Og til sidst: Den 18. juni betyder ikke, at ”alle dine projekter holder op med at fungere”. Det betyder, at den gratis kanal deaktiveres. Betalt Cloud API-adgang forbliver, Gemini CLI-repositoryet forbliver, og forks er stadig mulige. Hvis du brugte Free-abonnementet, skal du beslutte dig inden den 18. juni; ellers vil den næste gemini "something" returnere en godkendelsesfejl.