Antigravity CLI: den kompletta guiden

Kom igång

Vad är en terminal?

Terminalen är programmet där du startar Antigravity CLI och ger agenten uppgifter. Orden du möter där, som terminal, kommando, CLI och sökväg, förklaras i listan under texten.

Terminalen finns redan i din dator. På Mac öppnar du Terminal under Program, Verktygsprogram. På Windows söker du efter PowerShell i Start-menyn. På Linux heter programmet oftast Terminal.

Antigravity CLI arbetar i mappen där du startar agy. Starta därför alltid i ditt projekts mapp, aldrig i hela hemmappen. Kommandot mkdir skapar en ny mapp, och cd flyttar dig in i den.

Vad är Antigravity CLI?

Antigravity CLI är en kodagent, ett AI-program som inte bara svarar utan också gör arbetet. Agenten skriver och ändrar filer, kör kommandon, söker i koden och förklarar vad den har gjort. På antigravity.google kallar Google verktyget den lätta vägen in till Antigravity-agenterna, byggd för terminalen.

Antigravity CLI ersätter Gemini CLI för privatpersoner. Googles utvecklarblogg skrev den 19 maj 2026 att Antigravity CLI är skrivet i programspråket Go och kan köra flera agenter i bakgrunden. Verktyget behåller skills, hooks, subagenter och tillägg. Tilläggen heter nu Antigravity plugins. Delen Bygg ut längre ned förklarar vad de gör.

Google Antigravity är Googles plattform för kodagenter och finns för macOS, Windows, Linux och Googlebook. Plattformen består av fyra delar, enligt antigravity.google:

• Antigravity-appen, som styr flera agenter samtidigt.
• En kodeditor.
• Antigravity CLI, agenten i terminalen.
• Ett SDK, ett kodpaket för att bygga egna agenter.

Vem är Antigravity CLI till för?

Antigravity CLI är för dig som vill att en AI gör kodarbete i ett riktigt projekt. Agenten kan förklara okänd kod, rätta fel, bygga en liten app eller skriva tester, små program som kontrollerar att koden fungerar. Google skriver på produktsidan att verktyget passar den som bygger och trivs i terminalen.

Du behöver inte kunna programmera för att be om en förklaring. Du behöver däremot förstå vad du godkänner.

Privatpersoner loggar in med sitt Google-konto. Gemini CLI:s projektbeskrivning på GitHub pekar ut Antigravity CLI som rätt verktyg för gratiskonton, för Google AI Pro och Ultra och för Argon, Googles största modell. Företag når Antigravity CLI genom en affärsplan via Google Cloud, som avsnittet om pris beskriver.

Föredrar du fönster och knappar finns Antigravity-appen och kodeditorn på samma plattform. Vill du bara chatta med Gemini räcker Gemini-appen.

Hur installerar man Antigravity CLI?

Antigravity CLI installerar du med ett kommando som du klistrar in i terminalen. Kommandot hämtar ett installationsskript från antigravity.google och kör det. Ett skript är en fil med kommandon som datorn kör i tur och ordning. Kommandona nedan är kopierade från Googles nedladdningssida.

På Mac och Linux hämtar curl skriptet, och bash kör det. Programmet hamnar i ~/.local/bin/agy.

På Windows kör du kommandot i PowerShell. Programmet hamnar då i C:\Users\<användarnamn>\AppData\Local\agy\bin. Använder du CMD finns ett eget kommando för det.

Kontrollera sedan installationen med agy --version. Svarar terminalen med ett versionsnummer är du klar.

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

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

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

agy --version

Hur loggar man in i Antigravity CLI?

Antigravity CLI loggar in med ditt Google-konto. Först letar agy efter en sparad inloggning. Finns ingen öppnas webbläsaren. Där loggar du in med ditt personliga Google-konto, eller väljer affärsinloggning för ett företagskonto.

Datorn sparar inloggningen i sitt lösenordsförråd, som heter Nyckelringen på Mac, Credential Manager på Windows och Secret Service på Linux. Nästa gång loggar agy in utan att fråga. Kommandot /logout loggar ut och raderar de sparade uppgifterna.

En API-nyckel för Gemini fungerar också. Nyckeln är en lång kod som visar Google vem du är. Googles inloggningsguide beskriver två steg. Skriv först "modelProvider": "gemini" i inställningsfilen ~/.gemini/antigravity-cli/settings.json. Lägg sedan nyckeln i miljövariabeln GEMINI_API_KEY.

Antigravity CLI läser inte variabeln GOOGLE_API_KEY och inte heller filer som heter .env. Med en nyckel betalar du per anrop. Hur du skaffar nyckeln står i del 3 om Gemini API.

Din första session med Antigravity CLI, steg för steg

Första sessionen tar sju steg och bygger på Googles egen guide för att komma igång:

mkdir agy-demo && cd agy-demo
agy

mkdir agy-demo
cd agy-demo
agy

Så arbetar du

Hur fungerar Antigravity CLI?

Antigravity CLI arbetar i en agentslinga. Agenten läser, planerar, ändrar och kontrollerar, varv efter varv, tills uppgiften är klar. I varje varv bestämmer modellen vad som behövs, till exempel att läsa en fil eller köra ett test. Resultatet går tillbaka till modellen innan nästa steg.

Ditt godkännande är din kontroll. I standardläget visar agenten en diff och väntar innan den skapar eller ändrar en fil. Agenten frågar också innan den kör ett kommando. Principen kallas människa i loopen.

Stora uppgifter kan agenten dela med subagenter, alltså hjälpagenter. Varje subagent börjar med ett tomt minne i en egen konversation. Panelen /agents visar vad de gör och låter dig godkänna deras frågor.

Modellen väljer du med /model, och valet sparas till nästa gång. Esc avbryter agenten mitt i ett steg. Ctrl+C stoppar ett svar som håller på att skrivas.

Vilka lägen finns i Antigravity CLI?

Antigravity CLI har fyra lägen, enligt Googles sida om lägen. Läget bestämmer hur mycket agenten får göra utan att fråga. Shift+Tab byter läge under sessionen.

• default visar varje filändring och frågar innan varje kommando. Antigravity CLI startar alltid i det här läget, och här ska du börja.
• accept-edits godkänner filändringar i projektets mapp automatiskt. Kommandon frågar fortfarande.
• plan låter agenten undersöka och skriva en plan innan den rör någon kod. Du godkänner planen först.
• auto godkänner filändringar och kör kommandon i en sandlåda utan att fråga. En sandlåda är ett avgränsat utrymme som skyddar resten av datorn. Riskabla åtgärder frågar fortfarande. Läget kräver version 1.3.5 eller senare på Mac och Linux och 1.4.4 eller senare på Windows, enligt sidan om lägen. Du behöver också terminalsandlådan och ett personligt konto.

Hur skriver man en bra uppgift till Antigravity CLI?

En bra uppgift säger vad agenten ska göra, var, vilka regler som gäller och hur agenten vet att den är klar. Jämför "fixa inloggningen" med "Inloggningen i src/auth.ts släpper in fel lösenord. Hitta felet, rätta det och kör testerna. Ändra inga andra filer." Den andra uppgiften ger agenten ett mål och ett sätt att kontrollera resultatet.

Googles guide för god praxis ger två råd. Låt agenten undersöka, planera och utföra i separata steg. Ge den också ett sätt att kontrollera sig själv, till exempel tester eller ett byggkommando. Fler råd om att skriva till AI finns i promptguiden.

• Peka ut filer med @, till exempel @src/auth.ts. Då vet agenten exakt vilken fil du menar.
• Visa felet med en skärmbild. Kopiera bilden och tryck Ctrl+V i inmatningsrutan, som Googles guide för god praxis beskriver.
• Säg hur resultatet ska kontrolleras, med ett test, ett kommando eller något som ska synas.
• Säg vad som inte får ändras.
• Be om en förklaring innan du godkänner en ändring du inte förstår.
• Starta en ny konversation med /clear när du byter uppgift. Då stör inte det gamla sammanhanget.

Vad är GEMINI.md och AGENTS.md?

GEMINI.md och AGENTS.md är textfiler med regler som Antigravity CLI läser varje gång. I filerna skriver du det agenten alltid ska veta om ditt projekt, till exempel hur projektet startas, hur testerna körs och vilka regler koden följer. Google kallar sådana instruktioner rules.

Antigravity CLI letar efter filerna på flera ställen. I projektet läser agenten GEMINI.md, AGENTS.md och mappen .agents/rules/. Agenten letar i mappen där du startar agy och i mapparna ovanför, upp till projektets översta mapp. Undermappar läses inte.

Regler för alla dina projekt lägger du i ~/.gemini/GEMINI.md eller ~/.gemini/AGENTS.md. Agenten lägger ihop alla regler den hittar.

Håll filerna korta och konkreta. Varje fil kortas av efter en viss storlek, och globala regler och regler som alltid gäller delar på ett begränsat antal token, enligt Googles sida om regler. Gränserna står på samma sida. En token är ungefär en bit av ett ord, och varje rad tar plats i agentens arbetsminne, kontextfönstret.

# Projekt: Bokningssidan

## Kom igång
- Starta: npm run dev
- Testa: npm test

## Regler
- Skriv all text på svenska.
- Ändra aldrig filer i mappen migrations/.
- Kör testerna innan du säger att du är klar.

Vilka kommandon finns i Antigravity CLI?

Kommandon i Antigravity CLI börjar med snedstreck, och du skriver dem i inmatningsrutan. Enligt Googles kommandoreferens är de här de vanligaste:

• /help visar alla kommandon och kortkommandon.
• /config öppnar inställningarna, precis som /settings.
• /model väljer modell.
• /diff visar ändringarna.
• /clear börjar en ny konversation.
• /permissions bestämmer vilka kommandon som är tillåtna, kräver en fråga eller nekas.
• /mcp hanterar MCP-servrar, som förklaras längre ned.
• /plugin hanterar plugins, alltså tillägg.
• /usage visar hur mycket du har använt av kvoten, alltså användningen som ingår i din plan.
• /exit avslutar, precis som /quit.

Var ändrar man inställningarna i Antigravity CLI?

Antigravity CLI sparar inställningarna i filen ~/.gemini/antigravity-cli/settings.json. Enklast ändrar du dem med /config. En panel öppnas, du väljer med piltangenterna, och ändringen sparas direkt i filen. Esc stänger panelen.

Tre inställningar är bra att känna till. agentMode bestämmer vilket läge agenten startar i. enableTerminalSandbox slår på sandlådan för kommandon. useG1Credits låter Antigravity CLI använda dina AI-krediter när kvoten i planen är slut. Googles inställningssida anger att useG1Credits är avstängd från början.

Flaggor ändrar en enda körning. agy --mode=plan startar direkt i planläget, och agy --sandbox startar med sandlådan påslagen. agy -c fortsätter den senaste konversationen.

Bygg ut

Hur kopplar man MCP-servrar till Antigravity CLI?

MCP, Model Context Protocol, är en öppen standard som ger en AI-agent nya verktyg, till exempel en databas, GitHub, ett ärendesystem eller en webbläsare. En MCP-server är ett litet program som erbjuder verktygen. Agenten använder dem sedan som sina egna.

MCP-servrarna skriver du in i en egen fil. Filen är skriven i JSON, ett textformat som program kan läsa. ~/.gemini/config/mcp_config.json gäller alla projekt, och .agents/mcp_config.json gäller ett enda projekt.

Varje server står under mcpServers. En server på din dator anges med command och args, och en server på internet med serverUrl.

Kommandot /mcp öppnar en panel. Där ser du om servrarna är igång, laddar om filen och läser loggar. Exemplet nedan är Googles eget och startar en lokal server för en SQLite-databas.

{
  "mcpServers": {
    "sqlite-explorer": {
      "command": "node",
      "args": ["/usr/local/bin/sqlite-mcp-server.js"],
      "env": {
        "SQLITE_DB_PATH": "/var/data/app.db"
      }
    }
  }
}

Skills, plugins och hooks i Antigravity CLI

Googles funktionssida beskriver tre sätt att bygga ut Antigravity CLI:

Kan man köra Antigravity CLI i skript?

Antigravity CLI kan köra en enda uppgift utan dialog. Flaggan -p kör en fråga, skriver ut svaret och avslutar. Med --output-format json kommer svaret som JSON, så att ett annat program kan läsa det.

Googles guide för god praxis visar exemplet nedan. Agenten läser ändringarna i ett git-projekt och föreslår ett commit-meddelande, en kort beskrivning av ändringen. Ett sådant kommando kan ligga i ett skript, eller i ett automatiskt flöde för CI/CD som testar och publicerar kod.

agy -p "Review this git diff and draft a conventional commit message"

Pris och säkerhet

Vad kostar Antigravity CLI? Är det gratis?

Antigravity CLI går att använda gratis. Planen för individer kostar 0 dollar i månaden och ger flera agentmodeller med grundläggande veckogränser, enligt Googles prissida för Antigravity i skrivande stund. Google AI Pro ger högre gränser och Google AI Ultra ännu högre, visar samma sida. Planernas priser står i del 1 om Gemini.

Planerna ger olika modeller. Flash, Googles snabba modell för det mesta, ingår i gratisplanen, medan Argon, Googles största modell, kräver en betald plan, enligt Googles modellsida för Antigravity. Sidan listar också modeller från Claude och GPT. Utbudet ändras, så modellsidan visar vilka modeller som finns just nu.

Kommandot /usage visar hur mycket av kvoten du har använt, och /credits visar dina AI-krediter. Är kvoten slut kan Antigravity CLI fortsätta med AI-krediter, om du slår på useG1Credits.

Företag betalar via Google Cloud. Affärsplanerna börjar i skrivande stund på 30 dollar per användare och månad, enligt prissidan. Det finns också en plan utan månadsavgift, där företaget betalar efter användning.

Med en Gemini API-nyckel betalar du i stället per token. Hur priset räknas står i del 3. Priserna ändras, så kontrollera dem innan du väljer.

Är Antigravity CLI säkert? Integritet och sandlåda

Antigravity CLI kör kommandon på din dator med dina behörigheter. Godkänner du fel kommando kan agenten radera eller läcka filer. Ditt viktigaste skydd är att läsa varje diff och varje kommando innan du trycker Y.

Google kan använda det du skriver. Enligt villkoren för Antigravity använder Google dina prompter, din kod och agentens svar för att förbättra sina produkter. Anställda och underleverantörer kan läsa materialet, enligt samma villkor. Villkoren säger också att du kan ändra den användningen i inställningarna.

Inställningen heter enableTelemetry i Antigravity CLI. Valet sparas med ditt konto. För affärskonton är inställningen alltid avstängd.

Sandlådan stänger in kommandona. I sandlådan körs kommandona utan nätverk och kan bara skriva i projektets mappar. De når inte heller känsliga filer som ~/.ssh och .env. Sandlådan är avstängd från början. På Windows kräver sandlådan Windows 11 24H2 med augustiuppdateringen 2026 eller senare, enligt Googles sida om sandlådan.

Promptinjektion är den största risken med agenter. En webbsida, en fil eller ett ärende kan innehålla text som försöker få agenten att göra något du inte bett om. Läs mer om promptinjektion och i Är AI säkert?.

Fem vanor skyddar dig och din kod:

• Börja i läget default.
• Slå på sandlådan med agy --sandbox när du arbetar med okänd kod.
• Använd git, så att du alltid kan gå tillbaka till en tidigare version.
• Använd aldrig ett privat konto för kunduppgifter eller personuppgifter. Personuppgifter skyddas av GDPR.
• Lägg aldrig lösenord eller nycklar i GEMINI.md.

Andra verktyg

Gemini CLI: för företag och API-nycklar

Gemini CLI är Googles äldre kodagent för terminalen, med kommandot gemini. Google presenterade Gemini CLI i ett blogginlägg den 25 juni 2025. Koden är öppen under licensen Apache 2.0, enligt projektets sida på GitHub, så alla får läsa och ändra den.

Gemini CLI har ingen gratisnivå längre. Sedan den 18 juni 2026 är Gemini CLI byggt för organisationer med Gemini Code Assist Standard eller Enterprise och Code Assist for GitHub, enligt projektbeskrivningen på GitHub. Verktyget fungerar också med betalda nycklar för Gemini API. Gemini CLI är inte anpassat för Googles senaste modellserie, där Argon ingår, står det i samma projektbeskrivning.

Gemini Code Assist läggs ned. Nya kunder kan inte köpa Gemini Code Assist Standard eller Enterprise från den 9 oktober 2026, enligt Google Clouds sida om avvecklingen. Befintliga årsabonnemang kan förnyas till och med den 31 januari 2027, enligt samma sida. För kodagenter hänvisar Google där till Antigravity i Gemini Enterprise.

Gemini CLI installerar du med npm, och verktyget kräver Node.js 20.0.0 eller senare, enligt installationssidan. Nyckeln lägger du i GEMINI_API_KEY.

Byter du till Antigravity CLI läser agenten fortfarande din GEMINI.md. Kommandot agy plugin import gemini flyttar över dina tillägg. MCP-servrarna flyttar från settings.json till mcp_config.json.

npm install -g @google/gemini-cli

Antigravity CLI, Claude Code eller Codex?

Antigravity CLI, Claude Code och Codex är kodagenter av samma slag. Alla tre körs i terminalen, läser och ändrar kod, kör kommandon och frågar innan de gör något riskabelt. Alla tre läser också en instruktionsfil i projektet och kan kopplas till MCP-servrar.

Skillnaden ligger mest i bolaget bakom och i kontot du redan har. Antigravity CLI använder Googles modeller och, enligt Googles modellsida, även vissa modeller från andra bolag. Claude Code använder Anthropics modeller och Codex OpenAI:s. Har du redan en plan hos ett av bolagen, börja med det bolagets agent.

Vanliga frågor om Antigravity CLI