Google Antigravity CLI (agy) Commando's & Configuratie Spiekbrief

Antigravity CLI (agy) is Google's lichte, op Go gebaseerde terminal-native codeeragent binnen het Antigravity 2.0-platform. Gebouwd voor parallelle subagent-uitvoering, Git-worktree-isolatie, Agent Skills, plug-ins en MCP-integraties vervangt agy de consumentenversie van Gemini CLI.

Deze spiekbrief behandelt agy CLI-vlaggen en subcommando's, interactieve slash-commando's, sneltoetsen, .agents/- en mcp_config.json-configuratie, en migratiestappen vanuit Gemini CLI.

🔗 Gerelateerde spiekbrieven: Vergelijking van Terminal AI-codeer-CLI's · Claude Code CLI Spiekbrief · OpenAI Codex CLI Spiekbrief · AI Agent Skill Architectuur

1. Installatie, Subcommando's & Opstartvlaggen

1.1 Installatie & Starten

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

# Start interactieve TUI (volg bij eerste start de authenticatie-instructies op het scherm)
agy

1.2 Kernsubcommando's & Opstartvlaggen

Commando / Vlag	Beschrijving	Gebruiksvoorbeeld
`agy`	Start interactieve TUI in de actieve werkruimte	`agy`
`agy -p "<prompt>"`	Niet-interactieve (headless) uitvoering, schrijft uitvoer naar stdout en sluit af	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Start interactieve sessie vooraf geladen met een beginprompt	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Hervat de meest recente gesprekssessie	`agy -c`
`agy --conversation <id>`	Laad een specifiek historisch gesprek op basis van ID	`agy --conversation 42a506e6-...`
`--mode <mode>`	Stel uitvoeringsrechtenmodus in: `default` · `accept-edits` · `auto` (automatisch goedkeuren in sandbox) · `plan`	`agy --mode accept-edits`
`--model <model>`	Overschrijf het actieve model voor deze sessie	`agy --model gemini-3.8-flash`
`--effort <level>`	Stel redeneerniveau in (`low` t/m `max`, modelafhankelijk)	`agy --effort high`
`--agent <agent>`	Koppel bij het opstarten een aangepast agentprofiel	`agy --agent reviewer`
`--add-dir <path>`	Geef toegang tot werkruimtecontext voor een extra map (herhaalbaar)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Toon beschikbare modellen of geconfigureerde aangepaste agenten	`agy models`
`agy plugin <subcmd>`	Beheer plug-ins: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Interactieve TUI Slash-commando's

Typ / binnen agy om ingebouwde commando's op te roepen en automatisch aan te vullen:

2.1 Algemeen, Sessie- & Geschiedenisbeheer

Commando	Functie	Opmerkingen & Gebruik
`?` / `/help`	Toon alle beschikbare slash-commando's en sneltoetsen	Snelle referentie tijdens de sessie
`/config` / `/settings`	Open schermvullend interactief instellingenvenster	Bewerk voorkeuren, thema's en rechten (`settings.json`)
`/clear`	Wis actieve promptbuffer en start een schone sessie	Stap netjes over op een niet-gerelateerde taak
`/compact`	Comprimeer en vat de gespreksgeschiedenis samen	Win contextruimte terug bij langlopende sessies
`/resume`	Open gesprekskiezer om eerdere sessies te herstellen	Zet onderbroken workflows voort
`/rewind` / `/undo`	Stap achterwaarts door gespreksbeurten heen	Draai foutieve beurten of richtingen terug
`/fork`	Splits het gesprek op het huidige controlepunt af	Verken veilig parallelle werkruimtebranches
`/exit` / `/quit`	Sluit de `agy` CLI-sessie af	Of druk op `Ctrl + D Ctrl + D`

2.2 Modellen, Workflows, Agenten & Extensies

Commando	Functie	Opmerkingen & Gebruik
`/model`	Wissel halverwege een sessie van actief AI-model	Balanceer snelheid/kosten versus redeneerkracht
`/effort`	Inspecteer of stel redeneer-effort in (`low` tot `max`)	Let op: `agy -p "/effort"` geeft alleen-lezen JSON-uitvoer
`/plan`	Genereer een stapsgewijs plan voordat bestanden worden gewijzigd	Veiligheidspoort vóór grote architectuurwijzigingen
`/goal`	Voer autonoom uit tot voltooiing zonder tussentijdse pauzes	Geschikt voor langlopende doeltaken
`/grill-me`	Voer een interactief eiseninterview uit vóór het coderen	Verduidelijk randgevallen en acceptatiecriteria vooraf
`/agent`	Schakel over naar of roep aangepaste subagent-/agentprofielen aan	Laadt definities uit `.agents/agents/`
`/worktree`	Maak geïsoleerde Git-worktree-mappen aan en beheer ze	Werk over parallelle branches zonder de hoofdboom te vervuilen
`/mcp`	Inspecteer live MCP-verbindingsstatus, logs en herlaad configuratie	Los problemen met lokale of externe MCP-servers op
`/plugin`	Blader door Marketplace-plug-ins, schakel ze in/uit of inspecteer ze	Beheer gebundelde skills, regels, hooks en MCP-servers
`/voice`	Schakel spraakdicteermodus in of uit	Sneltoetsequivalent: `F5`

3. Terminal-sneltoetsen & Invoersyntaxis

Sneltoets / Syntaxis	Actie	Effect & Scenario
`@<path>`	Automatisch aanvullen van bestandspad	Voeg specifieke bestands- of mappaden in de context in
`!<command>`	Inline terminaluitvoering	Zet `!` vooraan om shell-commando's direct uit te voeren (bijv. `!npm run build`)
`Ctrl + G`	Externe editor openen	Schrijf lange of meerregelige prompts in uw standaardeditor (Vim, VS Code)
`Esc Esc`	Actief promptvak wissen	Wis wachtende invoer wanneer er geen stream actief is
`F5`	Spraakdicteren in-/uitschakelen	Equivalent aan `/voice`
`Ctrl + D Ctrl + D`	Sessie afsluiten	Druk tweemaal op `Ctrl + D` om netjes af te sluiten

4. Configuratiehiërarchie & `mcp_config.json`

4.1 Kaart van Globale vs. Werkruimte-mappen

Laag	Wereldwijd bereik (alle werkruimtes)	Werkruimtebereik (projectlokaal)	Doel
CLI-instellingen	`~/.gemini/antigravity-cli/settings.json`	—	CLI-voorkeuren, thema, editor en standaardrechten
Sneltoetsen	`~/.gemini/antigravity-cli/keybindings.json`	—	Aangepaste terminaltoetstoewijzingen
Projectinstructies	`~/.gemini/AGENTS.md` of `GEMINI.md`	`./AGENTS.md` of `./GEMINI.md`	Permanente repo-conventies, build-/testcommando's, persona
Altijd-actieve regels	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Achtergrondbeperkingen automatisch geïnjecteerd in context
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Modulaire Agent Skills-pakketten met scripts en bronnen
MCP-configuratie	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definities voor lokale stdio- en externe HTTP MCP-servers

⚠️ Brekend schema voor externe MCP (serverUrl): In mcp_config.json moeten externe HTTP MCP-servers serverUrl gebruiken in plaats van de oude sleutels url of httpUrl—het gebruik van url veroorzaakt stille verbindingsfouten.

{
  "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. Migreren van Legacy Gemini CLI naar `agy`

De gratis consumentenlaag en Google AI Pro/Ultra-verzoeken op Gemini CLI zijn beëindigd op 18 juni 2026 (waardoor alleen zakelijke Gemini Code Assist en API-sleutelworkflows naar verbruik overblijven). Belangrijkste migratiekoppelingen naar agy:

Onderdeel	Legacy Gemini CLI	Antigravity CLI (`agy`)	Migratieactie
Runtime & Binary	Open-source TypeScript (`gemini`)	Op Go gebaseerde multi-agent CLI (`agy`)	Schakel aanroepen over naar `agy`; automatische onboarding draait bij opstarten
Extensies	Gemini CLI-extensies	Native Antigravity plug-ins	Voer `agy plugin import gemini` uit om te converteren en importeren
Instructiebestanden	`GEMINI.md`	`GEMINI.md` en `AGENTS.md`	Volledig compatibel—bestaande `GEMINI.md` werken ongewijzigd
Lokale Skills-pad	`.gemini/skills/`	`.agents/skills/`	Verplaats skill-mappen naar `.agents/skills/<name>/SKILL.md`
Legacy Workflows	`.agents/workflows/`	Gemigreerd naar Agent Skills	Converteer losse workflowbestanden naar `.agents/skills/` (`/migrate-workflows`)
MCP-config & sleutels	Inline in `settings.json` met `url`	Eigen `mcp_config.json` met `serverUrl`	Splits MCP-blokken af naar `mcp_config.json` en hernoem `url` naar `serverUrl`