Migration von Gemini CLI → Antigravity CLI

Google gab am 19. Mai 2026 bekannt, dass Gemini CLI überführt wird in Antigravity CLI. Für zahlende Enterprise-Kunden ändert sich nichts. Für alle mit einem Google AI Pro, Ultra oder kostenlosen Gemini Code Assist Account für Einzelpersonen stellt Gemini CLI den Betrieb am 18. Juni 2026 ein. Dies ist der Migrationsplan, den Sie an einem Abend durchführen können, inklusive Rollback, falls ein kritischer Workflow unterbrochen wird.

1. Die Ankündigung

Zwei Google-Kanäle veröffentlichten die Umstellung am selben Tag. Der Google Developers Blog legte den Zeitplan dar. Der @geminicli-Account auf X sicherte ein 30-tägiges Migrationsfenster für Nutzer der Individual-Ebene und eine explizite Ausnahmeregelung ohne Handlungsbedarf für Enterprise-Kunden zu.

Google DeepMind ordnete das Gesamtbild über einen separaten offiziellen Account ein — die CLI ist ein Teil eines dreiteiligen Developer-Angebots, kein eigenständiges Produkt:

Die offiziellen Migrations-Docs unter antigravity.google/docs/gcli-migration sind die Source of Truth für das Mapping der einzelnen Dateien. Die folgenden Schritte orientieren sich an deren Reihenfolge, wobei Fallstricke dort hervorgehoben werden, wo die Dokumentation sie nur implizit lässt.

2. TL;DR

• Deadline: 18. Juni 2026 (Individual-Ebene)
• Betroffen: Google AI Pro, Google AI Ultra, kostenloses Gemini Code Assist
• Nicht betroffen: Code Assist Standard / Enterprise, kostenpflichtige Gemini API-Keys
• Ersatz: Antigravity CLI (Binary: agy)
• Migration mit einem Befehl: agy plugin import gemini
• Manuelle Schritte erforderlich: .gemini/skills/ → .agents/skills/, MCP-Konfiguration zu mcp_config.json
• Feldumbenennung: Remote-MCP url → serverUrl
• Kontextdateien: GEMINI.md und AGENTS.md funktionieren unverändert weiter
• Parallele Installation: sicher — gemini und agy koexistieren
• Lesezeit für diesen Leitfaden: 14 Minuten; Umsetzung: ca. 45 Minuten

3. Der Zeitplan

4. Wer ist betroffen?

Führen Sie diesen kurzen Check durch, bevor Sie weiterlesen:

• Sie melden sich mit einem persönlichen Google-Konto bei der Gemini CLI an. Sie sind betroffen — dies ist der kostenlose / Consumer-Flow.
• Sie bezahlen für Google AI Pro oder Google AI Ultra. Sie sind betroffen. Die Antigravity CLI nutzt dasselbe Abonnement.
• Sie nutzen Gemini Code Assist für Einzelpersonen (Free-Tier). Sie sind betroffen. Sowohl die Gemini CLI als auch die Code Assist IDE-Erweiterung werden am 18. Juni eingestellt.
• Sie authentifizieren die Gemini CLI mit einem kostenpflichtigen Gemini API-Key. Sie sind nicht betroffen. Die Gemini CLI steht Nutzern mit kostenpflichtigen API-Keys weiterhin zur Verfügung.
• Ihre Organisation verfügt über eine Gemini Code Assist Standard- oder Enterprise-Lizenz. Sie sind nicht betroffen. Der Enterprise-CLI-Zugriff bleibt unverändert.

5. Enterprise-Ausnahmeregelung

Laut dem Google Developers Blog: “Wenn Ihr Unternehmen Gemini CLI oder unsere IDE-Erweiterungen über eine Gemini Code Assist Standard- oder Enterprise-Lizenz nutzt, oder wenn Ihr Unternehmen Gemini Code Assist für GitHub über Google Cloud verwendet, bleibt Ihr Zugriff unverändert. Wir werden Gemini CLI und Gemini Code Assist weiterhin unterstützen und Zugriff auf die neuesten Gemini-Modelle sowie weitere Updates bieten.”

Konkret behalten Unternehmen drei Optionen:

• Gemini CLI mit Standard- / Enterprise-Lizenz beibehalten — keine Migration erforderlich.
• Gemini CLI mit einem kostenpflichtigen API-Key beibehalten — keine Migration erforderlich.
• Antigravity CLI parallel einführen und GCP-Projekt-Anmeldedaten verwenden. Weitere Details zur Verknüpfung von GCP-Projekten finden Sie auf der offiziellen Enterprise-Seite.

Wenn Sie als Enterprise-Admin dies für jemand anderen lesen, lautet die wichtigste Botschaft für Sie: Planen Sie einen Pilotversuch, führen Sie keine überstürzte Migration für das gesamte Unternehmen durch. Die Frist gilt nur für den Consumer-Tier.

6. Pre-Flight-Checkliste

Bevor Sie mit der Migration beginnen, bestätigen Sie Folgendes:

• Ihr Rechner kann eine als Go-Binary verteilte Datei installieren (agy) — Sie verfügen über curl, irm oder Admin-Shell-Zugriff.
• Sie wissen, welches Google-Konto aktuell für Ihre Gemini CLI verwendet wird (die Migration übernimmt dasselbe Konto).
• Sie können Ihre installierten Gemini CLI-Erweiterungen auflisten (gemini extension list).
• Ihr ~/.gemini/ Verzeichnis ist intakt (es enthält Ihre globalen Regeln und Skills).
• Workspace-Projekte mit benutzerdefinierten .gemini/ Ordnern werden identifiziert — jeder einzelne muss für Skills auf Workspace-Ebene manuell verschoben werden.
• Wenn Sie Gemini CLI-Aufrufe über CI oder Cron skripten, benötigen Sie einen Flag-Day-Plan, um den Binärnamen (gemini → agy) und den Auth-Flow umzustellen.

7. Schritt 1: Antigravity CLI installieren

Ein Installationsbefehl pro Plattform aus der offiziellen README:

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

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

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

Überprüfen Sie nach der Installation:

agy --version
# expected: a version string is printed

Die Binärdatei heißt agy, nicht antigravity. Wenn Sie CLI-Aufrufe skripten, ist dies Ihre Umbenennung. Die Gemini CLI-Binärdatei geminibleibt bestehen; beide koexistieren.

8. Schritt 2: Authentifizieren

Der erste Aufruf öffnet einen Auth-Flow. Zwei Varianten:

• Lokales Terminal. Führe agyaus. Dein Standardbrowser öffnet sich. Melde dich mit demselben Google-Konto an, das du für das Gemini CLI verwendet hast. Der Token wird in deinem System-Keyring gespeichert.
• Remote / SSH. Führe agyaus. Das CLI erkennt die SSH-Sitzung und gibt eine Autorisierungs-URL aus. Öffne diese auf deinem lokalen Rechner, schließe den OAuth-Flow ab und die SSH-Sitzung übernimmt den Token. Dies war ein bekannter Schwachpunkt im frühen Gemini CLI — jetzt erstklassig integriert.
• Enterprise. Während des Onboardings kannst du ein GCP-Projekt verknüpfen. Die Aufrufe werden dann über dieses Projekt abgerechnet. Die offiziellen Enterprise-Dokumente enthalten die Details dazu.

9. Schritt 3: Plugins importieren

On first launch, Antigravity CLI prompts to migrate Gemini CLI extensions to Antigravity plugins. If you skip the prompt or are installing on a fresh machine, run the import explicitly:

agy plugin import gemini

Beispielhafte Ausgabe aus der offiziellen Migrations-Dokumentation für eine Erweiterung mit mehreren Komponenten:

[ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
[ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

10. Schritt 4: MCP-Konfigurationen verschieben

Gemini CLI speicherte MCP-Server inline in settings.json. Antigravity CLI verwendet eine separate Datei. Verschieben Sie diese:

Und eine Feldumbenennung im JSON selbst:

// Gemini CLI (settings.json)
{
  "mcpServers": {
    "my-remote-mcp": {
      "url": "https://example.com/mcp"   // or the deprecated "httpUrl"
    }
  }
}

// Antigravity CLI (mcp_config.json)
{
  "my-remote-mcp": {
    "serverUrl": "https://example.com/mcp"
  }
}

Remote MCP-Server schlagen lautlos fehl, wenn Sie url kopieren, ohne sie umzubenennen. Lokale MCP-Server-Einträge mit command + args benötigen keine Umbenennung. Hintergrundinformationen zur MCP-Konfiguration finden Sie in unserem MCP-Tutorial.

11. Schritt 5: Workspace-Skills verschieben

Globale Skills unter ~/.gemini/skills/ werden automatisch geladen — keine Aktion erforderlich. Workspace-Skills unter .gemini/skills/ müssen verschoben werden nach .agents/skills/:

# Per project, from the workspace root:
mkdir -p .agents
git mv .gemini/skills .agents/skills
# Or, if not in git:
mv .gemini/skills .agents/skills

Falls ein Workspace bereits einen .agents/skills/ Ordner hatte (der Fall mit zwei Speicherorten, den die Gemini CLI-Dokumentation erlaubte), behalten Sie diesen und entfernen Sie die .gemini/skills/ Kopie. Informationen zu Authoring-Patterns finden Sie in unserem Antigravity Skills-Einrichtungsleitfaden.

12. Schritt 6: Hooks und Context verifizieren

Zwei Dinge, die Sie bestätigen sollten, bevor Sie die Migration als abgeschlossen betrachten:

• Context-Dateien werden geladen. GEMINI.md und AGENTS.md im Workspace, plus ~/.gemini/GEMINI.md global, alle funktionieren weiterhin unverändert. Öffnen Sie eine Session und bitten Sie den Agent, eine bekannte Regel aus Ihrer Datei zu rezitieren.
• JSON-Hooks werden ausgelöst. Wenn Sie JSON-Hooks für Antigravity 2.0 oder Gemini CLI erstellt haben, gelten diese in der Antigravity CLI für dieselben Lifecycle-Momente. Ändern Sie eine Datei oder führen Sie einen Beispiel-Tool-Aufruf aus, um zu bestätigen, dass ein Ihnen bekannter Hook tatsächlich ausgelöst wird.

Für Regel-Muster siehe unsere Regel-Beispiele und GEMINI.md System-Prompt-Leitfaden.

13. Schritt 7: Validierung anhand realer Aufgaben

Der eine Schritt, den Sie nicht überspringen sollten. Wählen Sie eine Aufgabe, die Sie gestern in der Gemini CLI erledigt haben — ein Refactoring, eine Recherche-Session, eine Bearbeitung mehrerer Dateien — und führen Sie diese in der Antigravity CLI im selben Repo aus. Vergleichen Sie:

• Hat der Agent dieselben Tools in denselben Schritten erreicht?
• Wurden deine Skills-Slash-Commands an den richtigen Stellen ausgeführt?
• Wurden MCP-Server-Aufrufe ausgelöst? (Achte hier auf stille serverUrl Fehler.)
• Haben die Kontextdateien (GEMINI.md, AGENTS.md) das Verhalten auf die gleiche Weise beeinflusst?
• Wurden Hooks zu den erwarteten Lifecycle-Zeitpunkten aufgerufen?

Zwanzig bis dreißig Minuten für eine repräsentative Aufgabe liefern dir 90 % der benötigten Signale. Wenn sich alles reproduzieren lässt, bist du fertig. Falls etwas fehlschlägt, melde es und weiche für diesen Workflow auf das Gemini CLI aus, bis ein Fix vorliegt.

14. Rollback-Plan

Antigravity CLI und Gemini CLI koexistieren auf demselben Rechner. Es sind separate Binaries (agy vs. gemini), separate Konfigurationsbäume (~/.gemini/antigravity-cli/ neben ~/.gemini/), sowie separate Auth-Flows. Bis zum 18. Juni 2026 ist Ihr Rollback für jeden einzelnen Workflow ganz einfach: nutzen Sie weiterhin gemini für diese eine Aufgabe.

Nach dem 18. Juni beschränken sich die Rollback-Optionen auf:

• Upgrade auf eine Enterprise-Lizenz (Gemini Code Assist Standard / Enterprise).
• Wechsel zu einem kostenpflichtigen Gemini API-Key.
• Verwenden Sie Antigravity 2.0 (die GUI) anstelle des CLI für den betroffenen Workflow.
• Verwenden Sie ein komplett anderes Agent-CLI. Siehe unsere Übersicht der Alternativen für die aktuelle Marktübersicht.

15. Die Änderungen auf einen Blick

16. FAQ

17. Fazit

Wenn Sie heute genau eine Sache tun: Installieren Sie Antigravity CLI auf dem Rechner, auf dem Sie Gemini CLI am häufigsten genutzt haben. Alles Weitere ist danach ein geringerer Aufwand.

Quellen

• Google Developers Blog — Ein wichtiges Update: Übergang von Gemini CLI zu Antigravity CLI
• @geminicli auf X — Ankündigung des Übergangs
• Antigravity CLI — Migration von Gemini CLI (offizielle Dokumentation)
• Einführung von Google Antigravity CLI — antigravity.google
• Einführung von Google Antigravity 2.0 — antigravity.google
• Antigravity CLI Übersicht — offizielle Dokumentation
• google-antigravity/antigravity-cli — GitHub Repository