Google Antigravity CLI (agy) Spickzettel: Befehle & Konfiguration

Antigravity CLI (agy) ist Googles leichtgewichtiger, in Go geschriebener terminal-nativer Coding-Agent der Plattform Antigravity 2.0. Konzipiert für parallele Subagent-Ausführung, Git-Worktree-Isolation, Agent Skills, Plugins und MCP-Integrationen ersetzt agy die eingestellte Consumer-Variante von Gemini CLI.

Dieser Spickzettel behandelt Start-Flags und Unterbefehle von agy, interaktive Slash-Befehle, Tastenkürzel, die Konfiguration über .agents/ und mcp_config.json sowie die Migrationsschritte von Gemini CLI.

🔗 Verwandte Spickzettel: Terminal-KI-Coding-CLIs im Vergleich · Claude Code CLI Spickzettel · OpenAI Codex CLI Spickzettel · AI Agent Skill Architecture Spickzettel

1. Installation, Unterbefehle & Start-Flags

1.1 Installation & Start

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

# Interaktive TUI starten (beim ersten Start den Auth-Anweisungen folgen)
agy

1.2 Zentrale Unterbefehle & Start-Flags

Befehl / Flag	Beschreibung	Beispielaufruf
`agy`	Interaktive TUI im aktiven Workspace starten	`agy`
`agy -p "<prompt>"`	Nicht-interaktiver (Headless-)Lauf, schreibt nach stdout und beendet sich	`agy -p "Summarize the last 5 commits"`
`agy -i "<prompt>"`	Interaktive Sitzung direkt mit Start-Prompt beginnen	`agy -i "Refactor auth middleware under src/auth"`
`agy -c`, `--continue`	Letzte Konversationssitzung fortsetzen	`agy -c`
`agy --conversation <id>`	Bestimmte historische Konversation per ID laden	`agy --conversation 42a506e6-...`
`--mode <mode>`	Ausführungs-Berechtigungsmodus festlegen: `default` · `accept-edits` · `auto` (Sandbox-Auto-Freigabe) · `plan`	`agy --mode accept-edits`
`--model <model>`	Aktives Modell für diese Sitzung überschreiben	`agy --model gemini-3.8-flash`
`--effort <level>`	Reasoning-Effort festlegen (`low` bis `max`, modellabhängig)	`agy --effort high`
`--agent <agent>`	Benutzerdefiniertes Agenten-Profil beim Start laden	`agy --agent reviewer`
`--add-dir <path>`	Workspace-Kontextzugriff auf weiteres Verzeichnis gewähren (wiederholbar)	`agy --add-dir ../shared-types`
`agy models` / `agy agents`	Verfügbare Modelle oder konfigurierte eigene Agenten auflisten	`agy models`
`agy plugin <subcmd>`	Plugins verwalten: `install` · `list` · `validate --strict` · `import gemini`	`agy plugin validate --strict ./my-plugin`

2. Interaktive TUI-Slash-Befehle

Tippen Sie / in agy, um integrierte Befehle aufzurufen und automatisch zu vervollständigen:

2.1 Allgemeine, Sitzungs- & Verlaufssteuerung

Befehl	Funktion	Hinweise & Anwendung
`?` / `/help`	Alle verfügbaren Slash-Befehle und Tastenkürzel auflisten	Schnelle Referenz innerhalb der Sitzung
`/config` / `/settings`	Interaktives Vollbild-Einstellungsmenü öffnen	Einstellungen, Themes und Berechtigungen bearbeiten (`settings.json`)
`/clear`	Aktiven Prompt-Puffer leeren und frische Sitzung starten	Sauber zu einer unabhängigen Aufgabe wechseln
`/compact`	Konversationsverlauf komprimieren und zusammenfassen	Kontextspielraum bei langen Läufen zurückgewinnen
`/resume`	Konversationsauswahl zum Fortsetzen früherer Sitzungen öffnen	Unterbrochene Workflows nahtlos weiterführen
`/rewind` / `/undo`	Schrittweise durch Konversations-Turns zurückspringen	Fehlerhafte Züge oder Richtungswechsel rückgängig machen
`/fork`	Konversation am aktuellen Checkpoint verzweigen	Parallele Workspace-Zweige gefahrlos erkunden
`/exit` / `/quit`	`agy`-CLI-Sitzung beenden	Oder `Ctrl + D Ctrl + D` drücken

2.2 Modelle, Workflows, Agenten & Erweiterungen

Befehl	Funktion	Hinweise & Anwendung
`/model`	Aktives KI-Modell während der Sitzung wechseln	Geschwindigkeit/Kosten gegen Reasoning-Tiefe abwägen
`/effort`	Reasoning-Effort prüfen oder festlegen (`low` bis `max`)	Hinweis: `agy -p "/effort"` liefert schreibgeschützte JSON-Ausgabe
`/plan`	Schritt-für-Schritt-Plan vor Dateiänderungen erstellen	Sicherheitsstufe vor großen Architekturänderungen
`/goal`	Autonom bis zum Abschluss laufen lassen, ohne Zwischenstopps	Geeignet für langfristige Aufgaben
`/grill-me`	Interaktives Anforderungsinterview vor dem Coding führen	Randfälle und Akzeptanzkriterien vorab klären
`/agent`	Eigene Subagent-/Agenten-Profile wechseln oder aufrufen	Lädt Definitionen aus `.agents/agents/`
`/worktree`	Isolierte Git-Worktree-Verzeichnisse anlegen oder verwalten	Auf parallelen Branches arbeiten, ohne den Hauptbaum zu belasten
`/mcp`	Live-Verbindungsstatus und Logs von MCP prüfen sowie neu laden	Lokale oder entfernte MCP-Server debuggen
`/plugin`	Marketplace-Plugins durchsuchen, aktivieren, deaktivieren oder prüfen	Gebündelte Skills, Regeln, Hooks und MCP-Server verwalten
`/voice`	Spracheingabe-Diktiermodus umschalten	Tastenkürzel-Äquivalent: `F5`

3. Terminal-Tastenkürzel & Eingabesyntax

Kürzel / Syntax	Aktion	Wirkung & Szenario
`@<path>`	Dateipfad-Autovervollständigung	Bestimmte Datei- oder Verzeichnispfade in den Kontext einfügen
`!<command>`	Inline-Terminalausführung	Mit `!` vorangestellte Shell-Befehle direkt ausführen (z. B. `!npm run build`)
`Ctrl + G`	Externen Editor öffnen	Lange oder mehrzeilige Prompts im Standard-Editor verfassen (Vim, VS Code)
`Esc Esc`	Aktives Prompt-Feld leeren	Ausstehende Eingabe löschen, wenn kein Stream aktiv ist
`F5`	Sprachdiktat umschalten	Entspricht `/voice`
`Ctrl + D Ctrl + D`	Sitzung beenden	Zweimal `Ctrl + D` drücken für sauberes Beenden

4. Konfigurationshierarchie & `mcp_config.json`

4.1 Globale vs. Workspace-Verzeichnisstruktur

Ebene	Globaler Bereich (alle Workspaces)	Workspace-Bereich (projektlokal)	Zweck
CLI-Einstellungen	`~/.gemini/antigravity-cli/settings.json`	—	CLI-Vorgaben, Theme, Editor und Standardberechtigungen
Tastenkürzel	`~/.gemini/antigravity-cli/keybindings.json`	—	Eigene Terminal-Tastenbelegungen
Projektanweisungen	`~/.gemini/AGENTS.md` oder `GEMINI.md`	`./AGENTS.md` oder `./GEMINI.md`	Dauerhafte Repo-Konventionen, Build-/Testbefehle, Persona
Ständige Regeln	`~/.gemini/config/rules/*.md`	`.agents/rules/*.md`	Hintergrundvorgaben, die automatisch in den Kontext geladen werden
Agent Skills	`~/.gemini/config/skills/<name>/SKILL.md`	`.agents/skills/<name>/SKILL.md`	Modulare Agent-Skills-Pakete mit Skripten und Ressourcen
MCP-Konfiguration	`~/.gemini/config/mcp_config.json`	`.agents/mcp_config.json`	Definitionen für lokale stdio- und entfernte HTTP-MCP-Server

⚠️ Breaking Schema für Remote-MCP (serverUrl): In mcp_config.json müssen entfernte HTTP-MCP-Server serverUrl statt der veralteten Schlüssel url oder httpUrl verwenden – url führt zu stillen Verbindungsabbrüchen.

{
  "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. Migration von der alten Gemini CLI auf `agy`

Das kostenlose Consumer-Kontingent sowie Google AI Pro/Ultra-Anfragen in der Gemini CLI endeten am 18. Juni 2026 (nur Enterprise Gemini Code Assist und nutzungsbasierte API-Key-Workflows bleiben bestehen). Die wichtigsten Migrationszuordnungen zu agy:

Komponente	Alte Gemini CLI	Antigravity CLI (`agy`)	Migrationsmaßnahme
Laufzeit & Binary	Open-Source-TypeScript (`gemini`)	Go-basierte Multi-Agent-CLI (`agy`)	Aufrufe auf `agy` umstellen; Auto-Onboarding läuft beim Start
Erweiterungen	Gemini-CLI-Extensions	Native Antigravity-Plugins	`agy plugin import gemini` zur Konvertierung und Übernahme ausführen
Anweisungsdateien	`GEMINI.md`	`GEMINI.md` und `AGENTS.md`	Voll kompatibel – bestehende `GEMINI.md` funktioniert direkt weiter
Lokaler Skills-Pfad	`.gemini/skills/`	`.agents/skills/`	Skill-Ordner nach `.agents/skills/<name>/SKILL.md` verschieben
Alte Workflows	`.agents/workflows/`	Zu Agent Skills migriert	Einzeldatei-Workflows in `.agents/skills/` umwandeln (`/migrate-workflows`)
MCP-Konfig & Schlüssel	Inline in `settings.json` mit `url`	Eigene `mcp_config.json` mit `serverUrl`	MCP-Blöcke in `mcp_config.json` auslagern und `url` in `serverUrl` umbenennen