Antigravity CLI: praktische Anleitung für Googles agy

Antigravity CLI ist Googles Coding-Agent fürs Terminal. Du installierst ihn mit einem Skript, startest ihn mit agy im Projektordner, meldest dich mit deinem Google-Konto an und beschreibst die Aufgabe. Er liest deine Dateien, schlägt Änderungen und Befehle vor und fragt im Standardmodus nach, bevor er etwas ändert.

Wer Gemini CLI mit einem privaten Konto genutzt hat, landet hier. Google hat im Developer-Blog am 19. Mai 2026 angekündigt, dass Gemini CLI ab dem 18. Juni 2026 keine Anfragen von Google-AI-Pro- und -Ultra-Abonnenten sowie kostenlosen Nutzern von Gemini Code Assist für Einzelpersonen mehr bedient. Diese Anleitung behandelt Installation, Anmeldung, Projektanweisungen, Modelle und Effort, Modi und Rechte, MCP, die wichtigsten Befehle, den Umstieg von Gemini CLI und die Limits, die Google nennt. Alles folgt Googles Antigravity-Dokumentation mit Stand November 2026.

Was Antigravity CLI ist und für wen

Antigravity CLI ist der Terminal-Client von Google Antigravity, Googles agentenorientierter Entwicklungsplattform. Laut Google ist er in Go geschrieben und teilt sich das Agent-Harness mit der Desktop-App Antigravity 2.0; Verbesserungen am Agenten kommen also in beiden an. Die bekannten Bausteine aus Gemini CLI bleiben: Agent Skills, Hooks, Subagents und Extensions, die jetzt Plugins heißen.

Er passt zu dir, wenn du:

• Gemini CLI mit privatem Google-Konto, Google AI Pro oder Ultra genutzt hast;
• einen Coding-Agenten im Terminal willst, der Gemini-Modelle (und je nach Tarif weitere) nutzt;
• Antigravity schon am Desktop verwendest und denselben Agenten per SSH oder in Skripten brauchst.

Teams mit einer Lizenz für Gemini Code Assist Standard oder Enterprise oder einem bezahlten Gemini-API-Key können bei Gemini CLI bleiben; dafür gibt es unsere Gemini-CLI-Anleitung. Google sagt offen, dass es zum Start keine 1:1-Funktionsgleichheit gibt.

Installation

Unter macOS und Linux landet das Programm in ~/.local/bin/agy, unter Windows in AppData\Local\agy\bin. Prüfen:

agy --version

Anmelden

Wechsle ins Projekt und starte:

cd mein-projekt
agy

Beim ersten Start fragt agy nach Farbschema, Darstellungsmodus (Alt-Screen oder Inline) und ob du dem Ordner vertraust. Danach öffnet sich der Browser für die Anmeldung mit deinem Google-Konto. Private Konten im Free-, Pro- und Ultra-Tarif funktionieren, Business-Konten melden sich über Gemini Enterprise an. Das Token liegt im Schlüsselbund des Betriebssystems (Keychain, Secret Service oder Windows-Anmeldeinformationsverwaltung), spätere Starts kommen ohne Browser aus.

Weitere Wege:

• Per SSH: agy gibt eine URL aus. Öffne sie auf deinem eigenen Rechner, melde dich an und füge den Code im Terminal ein.
• Gemini-API-Key: setze "modelProvider": "gemini" in ~/.gemini/antigravity-cli/settings.json und exportiere GEMINI_API_KEY. Ohne diese Einstellung bewirkt der Key allein nichts.
• Google-Cloud-Anmeldedaten: gcloud auth application-default login ausführen und AGY_ADC_AUTH=true setzen.

/logout löscht die gespeicherte Anmeldung.

Die erste Aufgabe

Erkläre, wie das Zahlungsmodul aufgebaut ist, ergänze dann eine
Eingabeprüfung am Refund-Endpoint und lass die Tests laufen.

Ein paar Abkürzungen helfen von Anfang an: @ schlägt Dateipfade vor, ! am Anfang eines Prompts führt einen Shell-Befehl aus, ? zeigt die Hilfe mit den Slash-Befehlen. Für Skripte führt agy -p "fasse README.md zusammen" einen einzelnen Prompt ohne Oberfläche aus; mit --output-format json kann ein anderes Programm das Ergebnis lesen. agy -i "Prompt" öffnet die interaktive Oberfläche mit einem ersten Prompt.

Projektanweisungen: AGENTS.md oder GEMINI.md

Antigravity liest AGENTS.md oder GEMINI.md im Ordner, in dem du agy startest, und in den Elternordnern bis zur Repo-Wurzel. Beide sind immer aktiv und brauchen kein Frontmatter. Globale Regeln gehören nach ~/.gemini/AGENTS.md oder ~/.gemini/GEMINI.md. Regeln addieren sich, statt sich zu ersetzen.

# Projekt: billing-service

## Befehle
- Installieren: npm ci
- Testen: npm test (vor jedem "fertig" ausführen)

## Nicht
- Keine Dateien in src/generated ändern.

Feiner steuerst du mit Markdown-Dateien in .agents/rules/. Jede braucht Frontmatter mit einem trigger: always_on, model_decision, glob (greift, wenn der Agent passende Dateien anfasst) oder manual. Fehlt der Trigger oder ist er ungültig, wird die Regel stillschweigend verworfen; manual-Regeln funktionieren in der CLI nicht, weil sie keine Regel-Erwähnungen kennt. Halte die Dateien kurz: Jede wird nach 24.000 Byte abgeschnitten, und globale sowie always_on-Regeln teilen sich ein Budget von 20.000 Tokens.

Liest Codex oder ein anderer Agent schon deine AGENTS.md, nutzt Antigravity dieselbe Datei. Wie du einen Regelsatz mit Claude Code teilst, steht in CLAUDE.md vs. AGENTS.md.

Modelle und Effort

Das Modell wählst du pro Lauf mit --model (agy models listet sie auf) oder in der Session mit /model. Googles Modellseite führt Gemini-Modelle wie Gemini 3.8 Flash und Gemini 3.1 Pro neben Claude- und GPT-OSS-Modellen; welche du siehst, hängt vom Tarif ab.

Effort legt fest, wie gründlich das Modell nachdenkt. /effort öffnet eine Skala und speichert die Wahl als Standard; --effort low gilt nur für einen Lauf. Die Stufen heißen low, medium, high, xhigh und max, die meisten Modelle bieten aber nur low bis high, und Modelle mit festem Budget ignorieren die Einstellung.

Modi und Rechte

Starte mit --mode=accept-edits (oder auto, plan), wechsle mit Shift+Tab oder setze "agentMode" in ~/.gemini/antigravity-cli/settings.json. auto braucht die Sandbox und ein privates Konto (ab v1.3.5 unter macOS und Linux, ab v1.4.4 unter Windows); Business-Konten bekommen ihn nicht. --sandbox startet eine Session in der Terminal-Sandbox.

Feine Regeln stehen in derselben Datei als Listen allow, ask und deny, etwa command(git) oder mcp(sql/execute_mutation). Deny schlägt Ask, Ask schlägt Allow. /permissions bearbeitet sie in der Oberfläche. --dangerously-skip-permissions genehmigt alles; nutze es nur in einer Wegwerf-Umgebung. Warum, erklärt Sicherheit von KI-Coding-Agenten.

MCP-Server

MCP-Server stehen in einer eigenen Datei: ~/.gemini/config/mcp_config.json für alle Projekte, .agents/mcp_config.json für einen Workspace.

{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}

Remote-Server müssen Streamable HTTP nutzen; der alte HTTP+SSE-Transport und httpUrl werden nicht unterstützt. /mcp öffnet eine Verwaltung mit Status, Neuladen und Logs. Tools, die du nicht freigegeben hast, laufen im Ask-Modus.

Wichtige Befehle

In der Shell setzt agy -c die letzte Unterhaltung in diesem Ordner fort, --conversation <id> öffnet eine bestimmte. --add-dir nimmt einen weiteren Ordner in den Workspace auf.

Umstieg von Gemini CLI

Startest du agy zum ersten Mal auf einem Rechner mit Gemini-CLI-Konfiguration, fragt eine Checkliste, was übernommen werden soll: Extensions, globale Einstellungen, Session-Tokens und Darstellung. Was laut Googles Migrationsanleitung mitkommt und was nicht:

• Unverändert: GEMINI.md und AGENTS.md im Projekt, ~/.gemini/GEMINI.md und globale Skills in ~/.gemini/skills/.
• Umgewandelt: Extensions werden mit agy plugin import gemini zu Plugins, ihre Befehle zu Skills.
• Von Hand verschieben: Workspace-Skills von .gemini/skills/ nach .agents/skills/; MCP-Server aus ~/.gemini/settings.json in mcp_config.json, dabei url oder httpUrl in serverUrl umbenennen.
• Nicht garantiert: manche eigenen Themes und visuellen Overlays.
• Flags: --approval-mode gibt es nicht mehr, nimm --mode. Einen yolo-Modus gibt es nicht.

Limits und Preise

Googles Tarifseite schließt die CLI in jeden Tarif ein und beschreibt Kontingente ohne Zahlen: Ultra hat das höchste Kontingent, alle fünf Stunden erneuert; Pro ein hohes, alle fünf Stunden erneuert bis zu einem Wochenlimit; andere Tarife ein wöchentlich erneuertes Kontingent. Die Limits richten sich danach, wie viel Arbeit der Agent erledigt. Bei Pro und Ultra können AI-Credits nach dem Kontingent einspringen, abgerechnet zu den Verbrauchspreisen von Gemini Enterprise; eine Einstellung schaltet das ab. /usage und /credits zeigen den Stand.

Neben Claude Code und Codex

Antigravity ist oft nur einer von mehreren Agenten. Ein paar Gewohnheiten halten Ordnung:

• Eine gemeinsame Regeldatei. Antigravity und Codex lesen beide AGENTS.md; Claude Code liest CLAUDE.md, die darauf verweisen kann.
• Ein Worktree pro Agent. Gib jedem Agenten seinen eigenen Git-Worktree, damit sie nicht dieselben Dateien bearbeiten.
• Überall dieselben MCP-Server. Jedes Tool hat seine eigene Konfiguration, also trägst du denselben Server dreimal ein.

Wir bauen AgentVera, eine Desktop-App für macOS, Windows und Linux, die Antigravity CLI neben Claude Code, Codex, Gemini CLI und anderen Agenten ausführt, jeden in einem echten Terminal mit deiner eigenen Installation und Anmeldung. Für Antigravity im Einzelnen (Details):

• Workspace: Antigravity ist eine Kachel im Agenten-Raster pro Projekt und kehrt nach einem Neustart in seine Unterhaltung zurück.
• Rechte: pro Agent Fragen, Auto (--mode=accept-edits) oder Vollzugriff (--dangerously-skip-permissions).
• Modell und Effort: beim Anlegen des Agenten ein Modell und low, medium oder high wählen.
• Anweisungen: agy hat kein Flag für zusätzliche Anweisungen, also bleiben Regeln in AGENTS.md oder GEMINI.md.
• MCP-Manager: einmal eingerichtete Server kommen beim Start zu Antigravity hinzu, neben deiner eigenen mcp_config.json.
• Worktrees: im Git-Panel einen anlegen und Antigravity darin starten, Claude Code in einem anderen.

Raster, Worktrees, Code-Review und MCP-Manager gehören zum Free-Tarif. Wie Googles Agenten im Vergleich zu Anthropic abschneiden, steht in Gemini CLI vs. Claude Code; oder du lädst AgentVera herunter.

Fazit

Per Skript installieren, agy starten, mit Google anmelden und die vorhandene AGENTS.md oder GEMINI.md behalten. MCP-Server nach mcp_config.json verschieben, Extensions mit agy plugin import gemini importieren, im Modus default oder accept-edits beginnen und vor langen Sessions /usage prüfen.