Migrera från Gemini CLI till Antigravity CLI: en guide

Den 19 maj 2026 meddelade Google att de skulle stänga ned gamla Gemini CLI för alla Free-, Pro- och Ultra-abonnemang den 18 juni. Två veckor efter att den här guiden publicerats slutar kommandot gemini att behandla förfrågningar. Att migrera från Gemini CLI till Antigravity CLI med kommandot agy är det enda sättet att fortsätta använda Googles verktyg. agy är byggt i Go och startar tiotals gånger snabbare.

Om du har något som körs med Gemini CLI – CI-skript, nattliga cron-jobb eller IDE-tillägget Gemini Code Assist – förklarar den här guiden hur du migrerar på en kväll utan att något går sönder.

Vad slutar egentligen fungera den 18 juni 2026?#

Det här är inte en ”fullständig nedläggning av projektet”, utan ett stopp för de tre populäraste abonnemangen. Vilka påverkas:

Från det officiella Google Developers Blog:

Om du använde Free-abonnemanget, liksom de flesta enskilda utvecklare, och tänker ”men jag har ett betalt konto” – kontrollera exakt hur ditt API-nyckelanrop debiteras. AI Pro är inte Cloud-fakturering; det är ett personligt Google AI-abonnemang, och det inaktiveras. Cloud-fakturering med ett betalt projekt inaktiveras inte.

Varför stänger Google ned Gemini CLI över huvud taget?#

Gamla gemini startade på ”hundratals millisekunder” eftersom Node.js behövde värmas upp. Nya agy är byggt som en enda statisk Go-binär och startar på ”millisekunder”. För CI och skript som anropar CLI hundratals gånger per körning är skillnaden betydande.

Det här säger Google om hastigheten och orsaken:

Alla viktiga funktioner i Gemini CLI har flyttats över:

• Agent Skills — mappen .gemini/skills/ finns nu i .agents/skills/.
• Hooks — samma händelser (PreToolUse, PostToolUse osv.); syntaxen har knappt ändrats.
• Subagents — fungerar som tidigare och deras konfiguration migreras automatiskt.
• Extensions — har bytt namn till Antigravity-pluginer och importeras med ett kommando.

Det som INTE migrerades sömlöst: MCP-servrar och gamla skript som direkt använder .gemini/config.json. Enligt GitHub-diskussionen rapporterar vissa användare att MCP-konfigurationer slutar fungera och måste skrivas om manuellt. Det finns ett separat avsnitt om detta längre ned.

Google stänger inte ned Gemini CLI-projektet med öppen källkod:

Det betyder att du kan forka det och fortsätta använda det med din egen Gemini API-nyckel. Men det här blir nu en betald konfiguration via Cloud-fakturering; den kostnadsfria Code Assist-lösningen upphör.

Så installerar du Antigravity CLI: kommandon för macOS, Linux och Windows#

Gör en snabb självkontroll innan du börjar: vilket abonnemang har du? Om du har ett betalt Cloud-projekt utan någon tidsfrist den 18 juni är migreringen användbar men inte brådskande. Om du har Free/Pro/Ultra och något körs via CLI, byt nu medan abonnemangen fortfarande är aktiva, så att du kan jämföra beteendet för samma uppgift.

macOS och Linux

Enradigt kommando med curl:

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

Skriptet identifierar plattformen, laddar ned agy-binären, kontrollerar dess kontrollsumma och placerar den i ~/.local/bin. Om den här mappen inte finns i PATH lägger du till den:

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

Kontrollera att binären är synlig:

which agy
agy --version

Windows (PowerShell)

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

Binären installeras i C:\Users\[your_name]\AppData\Local\agy\bin. Installationsprogrammet uppdaterar PATH automatiskt, men öppna ett nytt PowerShell-fönster för att läsa in variablerna på nytt.

Windows (CMD)

Om PowerShell blockeras av företagets policy:

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

Kontrollera installationen

Kör följande efter installationen på valfritt operativsystem:

agy doctor

Kommandot kontrollerar binärversionen, om det finns en konfiguration, autentisering och nätverksåtkomst till antigravity.google. Om det inte går att nå Google beror problemet på din region eller proxy.

Autentisering

Första gången du kör agy utan argument startas en installationsguide:

1. Välj ett gränssnittstema.
2. Välj autentiseringsmetod: Google OAuth (för personliga konton) eller en API-nyckel.
3. Importera eventuellt konfigurationen från .gemini/ direkt.

Om du väljer OAuth öppnas en webbläsare och omdirigerar dig till accounts.google.com; du måste godkänna datadelning. Därefter fungerar CLI.

Så migrerar du konfiguration och pluginer från .gemini till .agents#

Steg för steg:

1. agy plugin import gemini

   Kör kommandot från valfri mapp. Det migrerar globala pluginer från ~/.gemini/ till ~/.agents/. Kör kommandot i projektmappen för workspace-pluginer (intill projektet).

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

   Flytta skills genom att manuellt byta namn på mappen. Filformatet är detsamma; du behöver inte skriva om markdown-filerna.

3. agy inspect

   Visar vilka pluginer, skills, hooks och subagents som är aktiva. Jämför med listan du hade i Gemini CLI – ingenting bör saknas.

4. agy config --edit

   Öppnar konfigurationen i standardredigeraren ($EDITOR). Redigera manuellt sådant som inte hämtades in automatiskt.

5. agy doctor

   Slutkontroll: binär, autentisering, pluginer, nätverk. Om alla fyra lyser grönt är konfigurationsmigreringen klar.

Jag skulle låta den gamla .gemini/-mappen ligga kvar som säkerhetskopia i en månad, ifall något missats. När du har använt Antigravity i en vecka och bekräftat att allt finns där kan du ta bort den.

Om du använder AGENTS.md som en universell konfiguration för alla AI-verktyg behöver du inte ändra den. Antigravity CLI läser AGENTS.md från samma mapp som Claude Code eller Codex.

Vilka miljövariabler behöver ändras?#

Fullständig tabell över ersättningar:

Om du har GitHub Actions som skickar vidare secrets öppnar du Settings -> Secrets -> Actions och byter namn på nycklarna. Själva värdena är desamma (Googles API-nyckel ändrades inte under migreringen).

Kontrollera alla platser som kan innehålla GEMINI_:

# Sök efter omnämnanden i hela 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

Starta om terminalen efter bytet och kontrollera att hemligheten finns utan att skriva ut den. Aktivera inte skalspårning och kopiera inga nyckelvärden till loggar. Att variabeln finns bevisar inte behörighet; granska agy doctor separat:

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”

Vad brukar gå sönder under övergången och hur åtgärdar man det?#

Checklista över inledande problem:

1. MCP-servrar. Om du använde mcp_servers i .gemini/config.json kanske de inte hittas efter agy plugin import gemini. Kontrollera med agy inspect – där finns ett mcp-avsnitt. Om det är tomt eller innehåller fel skriver du om det manuellt med agy config --edit. Formatet beskrivs i den officiella Antigravity-dokumentationen (leta efter MCP-avsnittet).

2. Anpassade hooks. Om du hade ett bash-skript i .gemini/hooks/ som läste $GEMINI_API_KEY slutar det fungera. Hitta sådana ställen: bash

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

   Byt ut variablerna.

3. CI/CD. I GitHub Actions eller GitLab CI ändrar du steg som använder kommandot gemini till agy. Binärnamnet i installationsprogrammet kan skilja sig, så skapa en abstraktion med variabeln $CLI_CMD.

4. IDE-tillägg. Gemini Code Assist-tillägget för VS Code inaktiveras tillsammans med CLI. Ersättningen är Antigravity IDE (en separat VS Code-fork) eller AGENTS.md i valfri annan AI-redigerare.

5. Inläsning med @[file]. I tidiga versioner av Antigravity CLI hade kommandot @src/file.ts för att läsa in en fil i kontexten buggar. Uppdatera till den senaste versionen: agy update.

Om något kritiskt går sönder och inte kan åtgärdas inom en timme är en tillfällig lösning för Free-abonnemanget att fortsätta använda Gemini CLI fram till den 18 juni samtidigt som du konfigurerar migreringen på en separat gren i arkivet. Tidsgräns: 14 dagar.

Är det värt att stanna kvar med Googles verktyg efter den 18 juni?#

Antigravity 2.0 kan ses som ett reservalternativ när ditt primära verktyg (Claude Code eller Codex) inte passar. Läs guiden till Google Antigravity 2.0 för en utförlig genomgång av vad det är bra och mindre bra på.

En kort sammanfattning av vad du bör göra beroende på din situation:

Migreringschecklista på 15 minuter#

1. Installera 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. Starta agy och autentisera

   Utan argument: agy. Välj OAuth eller en API-nyckel.

3. Importera pluginer från .gemini

   agy plugin import gemini—detta migrerar tillägg globalt. Kör kommandot igen i projektmappen för workspace-pluginer.

4. Flytta skills

   mv .gemini/skills/ .agents/skills/. Filinnehållet förblir oförändrat.

5. Ersätt miljövariabler

   I ~/.zshrc/~/.bashrc och .env-filer: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Starta om terminalen.

6. Kontrollera installationen

   agy doctor – alla fyra posterna (binär, autentisering, pluginer, nätverk) ska lysa grönt.

7. Kör en testuppgift

   agy "write a README for the project in the current folder" – kontrollera att resultatet liknar det Gemini CLI gav.

8. Uppdatera GitHub Actions / GitLab CI

   Ändra kommandonamnet och secrets från GEMINI_* till AV_*.

9. Behåll .gemini/ som säkerhetskopia

   Du kan ta bort den 1–2 veckor efter att du bekräftat att allt fungerar.

Sist men inte minst: den 18 juni innebär inte att ”alla dina projekt slutar fungera”. Det betyder att den kostnadsfria kanalen inaktiveras. Åtkomsten till det betalda Cloud-API:t finns kvar, Gemini CLI-arkivet finns kvar och det går att skapa forkar. Om du använde Free-abonnemanget behöver du bestämma dig före den 18 juni; annars ger nästa gemini "something" ett autentiseringsfel.