Google Antigravity CLI (agy): Kommandon & Konfiguration Snabbguide

Antigravity CLI (agy) är Googles lätta, Go-baserade terminalintegrerade kodningsagent i Antigravity 2.0-plattformen. Byggd för parallell exekvering av subagenter, isolering med Git worktrees, Agent Skills, plugins och MCP-integrationer ersätter agy konsumentversionen av Gemini CLI.

Den här snabbguiden täcker agy CLI:s flaggor och underkommandon, interaktiva slash-kommandon, kortkommandon, konfiguration av .agents/ och mcp_config.json samt migreringssteg från Gemini CLI.

🔗 Relaterade snabbguider: Jämförelse av AI-kodningsverktyg för terminalen Snabbguide · Claude Code CLI Snabbguide · OpenAI Codex CLI Snabbguide · AI Agent Skill Arkitektur Snabbguide

1. Installation, Underkommandon & Startflaggor

1.1 Installation & Start

# Installera Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Starta interaktivt TUI (följ autentiseringsanvisningarna på skärmen vid första körningen)
agy

1.2 Grundläggande underkommandon & startflaggor

Kommando / Flagga	Beskrivning	Exempel på användning
`agy`	Starta interaktivt TUI i den aktiva arbetsytan	`agy`
`agy -p "<prompt>"`	Icke-interaktiv (headless) körning, skriver utdata till stdout och avslutar	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Starta interaktiv session förladdad med en inledande prompt	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Återuppta den senaste konversationssessionen	`agy -c`
`agy --conversation <id>`	Ladda en specifik historisk konversation via ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Ange behörighetsläge för körning: `default` · `accept-edits` · `auto` (sandlådebaserat autogodkännande) · `plan`	`agy --mode accept-edits`
`--model <model>`	Åsidosätt aktiv modell för denna session	`agy --model gemini-3.8-flash`
`--effort <level>`	Ange resonemangsinsats (`low` till `max`, modellberoende)	`agy --effort high`
`--agent <agent>`	Koppla en anpassad agentprofil vid start	`agy --agent reviewer`
`--add-dir <path>`	Ge arbetsytekontext åtkomst till en extra katalog (kan upprepas)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Lista tillgängliga modeller eller konfigurerade anpassade agenter	`agy models`
`agy plugin <subcmd>`	Hantera plugins: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Interaktiva Slash-kommandon i TUI

Skriv / inuti agy för att anropa och autokomplettera inbyggda kommandon:

2.1 Allmänt, Session & Historikkontroll

Kommando	Funktion	Anteckningar & användning
`?` / `/help`	Lista alla tillgängliga slash-kommandon och kortkommandon	Snabbreferens under session
`/config` / `/settings`	Öppna interaktiv helskärmsvy för inställningar	Redigera inställningar, teman och behörigheter (`settings.json`)
`/clear`	Rensa aktiv promptbuffert och starta en ny session	Byt smidigt till en orelaterad uppgift
`/compact`	Komprimera och sammanfatta konversationshistorik	Frigör kontextutrymme vid långa körningar
`/resume`	Öppna konversationsväljare för att återställa tidigare sessioner	Fortsätt avbrutna arbetsflöden
`/rewind` / `/undo`	Stega bakåt genom konversationsturer	Återställ felaktiga turer eller riktning
`/fork`	Förgrena konversationen vid aktuell kontrollpunkt	Utforska parallella arbetsgrenar säkert
`/exit` / `/quit`	Avsluta `agy` CLI-sessionen	Eller tryck `Ctrl + D Ctrl + D`

2.2 Modeller, Arbetsflöden, Agenter & Tillägg

Kommando	Funktion	Anteckningar & användning
`/model`	Byt aktiv AI-modell mitt i sessionen	Balansera hastighet/kostnad mot resonemangskraft
`/effort`	Inspektera eller ange resonemangsinsats (`low` till `max`)	Obs: `agy -p "/effort"` ger skrivskyddad JSON-utdata
`/plan`	Generera en steg-för-steg-plan före filändringar	Säkerhetsspärr före stora arkitekturändringar
`/goal`	Kör autonomt tills klart utan pauser under uppgiften	Lämpat för långsiktiga uppgifter
`/grill-me`	Kör en interaktiv kravintervju före kodning	Klargör gränsfall och acceptanskriterier i förväg
`/agent`	Växla eller anropa anpassade subagent-/agentprofiler	Laddar definitioner från `.agents/agents/`
`/worktree`	Skapa eller hantera isolerade Git worktree-kataloger	Arbeta över parallella grenar utan att smutsa ned huvudträdet
`/mcp`	Inspektera live-status för MCP-anslutningar, loggar och ladda om konfiguration	Felsök lokala eller fjärranslutna MCP-servrar
`/plugin`	Bläddra, aktivera, inaktivera eller inspektera Marketplace-plugins	Hantera paketerade skills, regler, hooks och MCP-servrar
`/voice`	Växla röstinmatningsläge (diktering)	Motsvarande kortkommando: `F5`

3. Kortkommandon i terminalen & Inmatningssyntax

Kortkommando / Syntax	Åtgärd	Effekt & scenario
`@<path>`	Autokomplettering för filsökväg	Infoga specifika fil- eller katalogsökvägar i kontexten
`!<command>`	Inbäddat terminalkommando	Använd prefixet `!` för att köra skalkommandon direkt (t.ex. `!npm run build`)
`Ctrl + G`	Öppna extern redigerare	Skriv långa eller flerradiga prompter i din standardredigerare (Vim, VS Code)
`Esc Esc`	Rensa aktivt promptfält	Rensa väntande inmatning när ingen ström är aktiv
`F5`	Växla röstinmatning	Motsvarar `/voice`
`Ctrl + D Ctrl + D`	Avsluta session	Dubbeltryck `Ctrl + D` för en ren avslutning

4. Konfigurationshierarki & `mcp_config.json`

4.1 Karta över globala vs. arbetsytekataloger

Lager	Global omfattning (alla arbetsytor)	Arbetsyteomfattning (projektlokal)	Syfte
CLI-inställningar	`~/.gemini/antigravity-cli/settings.json`	—	CLI-inställningar, tema, redigerare och standardbehörigheter
Kortkommandon	`~/.gemini/antigravity-cli/keybindings.json`	—	Anpassade tangentbordsmappningar i terminalen
Projektinstruktioner	`~/.gemini/AGENTS.md` eller `GEMINI.md`	`./AGENTS.md` eller `./GEMINI.md`	Beständiga arkivkonventioner, bygg-/testkommandon, persona
Alltid aktiva regler	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Bakgrundsbegränsningar som injiceras automatiskt i kontexten
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Modulära Agent Skills-paket med skript och resurser
MCP-konfiguration	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definitioner för lokala stdio- och fjärranslutna HTTP MCP-servrar

⚠️ Bakåtinkompatibelt schema för fjärr-MCP (serverUrl): I mcp_config.json måste fjärranslutna HTTP MCP-servrar använda serverUrl istället för äldre nycklar som url eller httpUrl — användning av url orsakar tysta anslutningsfel.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Migrering från äldre Gemini CLI till `agy`

Gratisnivån för konsumenter samt förfrågningar via Google AI Pro/Ultra på Gemini CLI upphörde den 18 juni 2026 (vilket endast lämnar kvar Gemini Code Assist för företag och användningsbaserade API-nyckelflöden). Viktiga migreringsmappningar till agy:

Komponent	Äldre Gemini CLI	Antigravity CLI (`agy`)	Migreringsåtgärd
Körtid & binär	Öppen källkod TypeScript (`gemini`)	Go-baserat multiagent-CLI (`agy`)	Byt anrop till `agy`; automatisk introduktionsguide körs vid start
Tillägg	Gemini CLI-tillägg	Inbyggda Antigravity-plugins	Kör `agy plugin import gemini` för att konvertera och importera
Instruktionsfiler	`GEMINI.md`	`GEMINI.md` och `AGENTS.md`	Fullt kompatibel — befintliga `GEMINI.md` fungerar direkt
Lokal sökväg för Skills	`.gemini/skills/`	`.agents/skills/`	Flytta skill-mappar till `.agents/skills/<name>/SKILL.md`
Äldre arbetsflöden	`.agents/workflows/`	Migrerade till Agent Skills	Konvertera enfilsarbetsflöden till `.agents/skills/` (`/migrate-workflows`)
MCP-konfig & nycklar	Inbäddad i `settings.json` med `url`	Dedikerad `mcp_config.json` med `serverUrl`	Dela upp MCP-block i `mcp_config.json` och byt namn på `url` till `serverUrl`