Von Gemini CLI zu Antigravity CLI migrieren: Ein Leitfaden

Am 19. Mai 2026 kündigte Google an, dass das alte Gemini CLI am 18. Juni für alle Free-, Pro- und Ultra-Tarife eingestellt wird. Zwei Wochen nach Veröffentlichung dieser Anleitung wird der Befehl gemini keine Anfragen mehr verarbeiten. Die Migration von Gemini CLI zu Antigravity CLI mit dem Befehl agy ist die einzige Möglichkeit, bei Google-Tools zu bleiben. agy ist in Go geschrieben und startet um ein Vielfaches schneller.

Wenn bei Ihnen irgendetwas mit Gemini CLI läuft – CI-Skripte, nächtliche Cron-Jobs oder die Gemini Code Assist-IDE-Erweiterung –, erklärt diese Anleitung, wie Sie an einem Abend migrieren, ohne etwas zu beschädigen.

Was ändert sich beim Wechsel von Gemini CLI zu Antigravity CLI?#

Es handelt sich nicht um eine „vollständige Einstellung des Projekts“, sondern um die Abschaltung der drei beliebtesten Tarife. Betroffen sind:

Aus dem offiziellen Google Developers Blog:

Wenn Sie den Free-Tarif wie die meisten einzelnen Entwickler genutzt haben und denken: „Aber ich habe doch ein kostenpflichtiges Konto“ – prüfen Sie genau, wie Ihr API-Schlüssel abgerechnet wird. AI Pro wird nicht über Cloud abgerechnet; es ist ein persönliches Google-AI-Abonnement und wird deaktiviert. Die Cloud-Abrechnung mit einem kostenpflichtigen Projekt wird nicht eingestellt.

Warum stellt Google Gemini CLI überhaupt ein?#

Das alte gemini startete in „Hunderten von Millisekunden“, weil Node.js erst anlaufen musste. Das neue agy ist als einzelne statische Go-Binärdatei gebaut und startet in „Millisekunden“. Bei CI und Skripten, die das CLI pro Durchlauf Hunderte Male aufrufen, ist der Unterschied erheblich.

Was Google zur Geschwindigkeit und zum Grund dafür sagt:

Alle wichtigen Funktionen von Gemini CLI wurden übernommen:

• Agent Skills — der Ordner .gemini/skills/ befindet sich jetzt in .agents/skills/.
• Hooks — dieselben Ereignisse (PreToolUse, PostToolUse usw.); die Syntax hat sich kaum geändert.
• Subagents — funktionieren wie zuvor, und ihre Konfiguration wird automatisch migriert.
• Extensions — wurden in Antigravity-Plugins umbenannt und lassen sich mit einem Befehl importieren.

Was nicht nahtlos migriert wurde: MCP-Server und alte Skripte, die direkt auf .gemini/config.json zugreifen. Laut der GitHub-Diskussion berichten einige Nutzer, dass MCP-Konfigurationen nicht mehr funktionieren und manuell neu geschrieben werden müssen. Weiter unten gibt es einen eigenen Abschnitt dazu.

Google schließt das Open-Source-Projekt Gemini CLI nicht:

Das bedeutet, dass Sie es forken und mit Ihrem eigenen Gemini-API-Schlüssel weiterverwenden können. Diese Einrichtung ist nun jedoch kostenpflichtig und wird über die Cloud-Abrechnung abgewickelt; das kostenlose Code-Assist-Angebot ist beendet.

Antigravity CLI installieren: Befehle für macOS, Linux und Windows#

Machen Sie vor dem Start einen kurzen Selbsttest: Welchen Tarif nutzen Sie? Wenn Sie ein kostenpflichtiges Cloud-Projekt ohne Frist am 18. Juni haben, ist eine Migration sinnvoll, aber nicht dringend. Wenn Sie Free, Pro oder Ultra nutzen und etwas über das CLI ausführen, wechseln Sie jetzt, solange die Tarife noch aktiv sind. So können Sie das Verhalten bei derselben Aufgabe vergleichen.

macOS und Linux

Einzeiler mit curl:

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

Das Skript erkennt die Plattform, lädt die agy-Binärdatei herunter, prüft ihre Prüfsumme und legt sie unter ~/.local/bin ab. Falls dieser Ordner nicht in PATH enthalten ist, fügen Sie ihn hinzu:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Prüfen Sie, ob die Binärdatei verfügbar ist:

which agy
agy --version

Windows (PowerShell)

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

Die Binärdatei wird unter C:\Users\[your_name]\AppData\Local\agy\bin installiert. Das Installationsprogramm aktualisiert PATH automatisch. Öffnen Sie jedoch ein neues PowerShell-Fenster, damit die Variablen neu geladen werden.

Windows (CMD)

Wenn PowerShell durch Ihre Unternehmensrichtlinien blockiert wird:

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

Installation überprüfen

Führen Sie nach der Installation unter jedem Betriebssystem Folgendes aus:

agy doctor

Der Befehl prüft die Version der Binärdatei, ob eine Konfiguration vorhanden ist, die Authentifizierung und den Netzwerkzugriff auf antigravity.google. Falls Google nicht erreichbar ist, liegt das Problem an Ihrer Region oder Ihrem Proxy.

Authentifizierung

Wenn Sie agy zum ersten Mal ohne Argumente ausführen, startet ein Einrichtungsassistent:

1. Wählen Sie ein Oberflächendesign.
2. Wählen Sie eine Authentifizierungsmethode: Google OAuth (für persönliche Konten) oder einen API-Schlüssel.
3. Importieren Sie optional gleich die Konfiguration aus .gemini/.

Wenn Sie OAuth auswählen, öffnet sich ein Browser und leitet Sie zu accounts.google.com weiter; Sie müssen der Datenfreigabe zustimmen. Danach funktioniert das CLI.

Konfiguration und Plugins von .gemini nach .agents migrieren#

Schritt für Schritt:

1. agy plugin import gemini

   Führen Sie den Befehl in einem beliebigen Ordner aus. Er migriert globale Plugins von ~/.gemini/ nach ~/.agents/. Für Workspace-Plugins (neben dem Projekt) führen Sie den Befehl im Projektordner aus.

2. mv .gemini/skills/ .agents/skills/

   Verschieben Sie Skills, indem Sie den Ordner manuell umbenennen. Das darin verwendete Dateiformat ist dasselbe; das Markdown muss nicht umgeschrieben werden.

3. agy inspect

   Zeigt, welche Plugins, Skills, Hooks und Subagents aktiv sind. Vergleichen Sie das mit der Liste in Gemini CLI – es sollte nichts fehlen.

4. agy config --edit

   Öffnet die Konfiguration im Standardeditor ($EDITOR). Wenn etwas nicht automatisch übernommen wurde, bearbeiten Sie es manuell.

5. agy doctor

   Abschließende Prüfung: Binärdatei, Authentifizierung, Plugins, Netzwerk. Wenn alle vier Punkte grün sind, ist die Migration der Konfiguration abgeschlossen.

Lassen Sie den alten Ordner .gemini/ vorsichtshalber einen Monat als Sicherung stehen, falls etwas übersehen wurde. Nachdem Sie Antigravity eine Woche lang verwendet und überprüft haben, dass alles vorhanden ist, können Sie ihn löschen.

Wenn Sie AGENTS.md als universelle Konfiguration für alle KI-Tools verwenden, müssen Sie daran nichts ändern. Antigravity CLI liest AGENTS.md im selben Ordner wie Claude Code oder Codex.

Welche Umgebungsvariablen müssen geändert werden?#

Vollständige Ersetzungstabelle:

Wenn Sie Secrets über GitHub Actions weitergeben, öffnen Sie Settings -> Secrets -> Actions und benennen Sie die Schlüssel um. Die Werte bleiben unverändert (der Google-API-Schlüssel hat sich bei der Migration nicht geändert).

Prüfen Sie alle Stellen, an denen GEMINI_ vorkommen könnte:

# Fundstellen im gesamten Projekt suchen
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# In Dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Starten Sie nach dem Ersetzen das Terminal neu und prüfen Sie nur das Vorhandensein, ohne das Geheimnis auszugeben. Aktivieren Sie kein Shell-Tracing und kopieren Sie keine Schlüsselwerte in Protokolle. Das Vorhandensein allein belegt keine Autorisierung; prüfen Sie diese separat mit agy doctor:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # sollte „authorized“ anzeigen

Was beim Wechsel am häufigsten schiefgeht und wie Sie es beheben#

Checkliste der anfänglichen Probleme:

1. MCP-Server. Wenn Sie mcp_servers in .gemini/config.json verwendet haben, werden sie nach agy plugin import gemini möglicherweise nicht übernommen. Prüfen Sie mit agy inspect – dort gibt es einen Abschnitt mcp. Wenn er leer ist oder Fehler enthält, schreiben Sie die Konfiguration manuell mit agy config --edit neu. Das Format wird in der offiziellen Antigravity-Dokumentation beschrieben (suchen Sie nach dem MCP-Abschnitt).

2. Benutzerdefinierte Hooks. Wenn Sie ein Bash-Skript in .gemini/hooks/ hatten, das $GEMINI_API_KEY las, wird es nicht mehr funktionieren. Suchen Sie nach solchen Stellen: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Ersetzen Sie die Variablen.

3. CI/CD. Ändern Sie in GitHub Actions oder GitLab CI die Schritte, die den Befehl gemini verwenden, zu agy. Der Binärname im Installationsprogramm kann abweichen; legen Sie daher mit der Variable $CLI_CMD eine Abstraktion an.

4. IDE-Erweiterung. Die Gemini Code Assist-Erweiterung für VS Code wird zusammen mit dem CLI deaktiviert. Der Ersatz ist Antigravity IDE (ein separater VS-Code-Fork) oder AGENTS.md in einem anderen KI-Editor.

5. Laden mit @[file]. In frühen Antigravity-CLI-Builds gab es Fehler beim Befehl @src/file.ts zum Laden einer Datei in den Kontext. Aktualisieren Sie auf die neueste Version: agy update.

Wenn etwas Kritisches kaputtgeht und sich nicht innerhalb einer Stunde beheben lässt, besteht eine vorübergehende Lösung für den Free-Tarif darin, Gemini CLI bis zum 18. Juni weiterzuverwenden und die Migration auf einem separaten Repository-Branch einzurichten. Zeitlimit: 14 Tage.

Lohnt es sich, nach dem 18. Juni bei Google-Tools zu bleiben?#

Antigravity 2.0 kann als Ausweichlösung dienen, wenn Ihr Hauptwerkzeug (Claude Code oder Codex) nicht geeignet ist. Einen ausführlichen Überblick über seine Stärken und Schwächen finden Sie in der Anleitung zu Google Antigravity 2.0.

Kurz zusammengefasst, was Sie je nach Situation tun sollten:

Migrationscheckliste in 15 Minuten#

1. Antigravity CLI installieren

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) oder irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. agy starten und authentifizieren

   Ohne Argumente: agy. Wählen Sie OAuth oder einen API-Schlüssel.

3. Plugins aus .gemini importieren

   agy plugin import gemini – migriert globale Erweiterungen. Führen Sie den Befehl im Projektordner erneut aus, um Workspace-Plugins zu migrieren.

4. Skills verschieben

   mv .gemini/skills/ .agents/skills/. Der Dateiinhalt bleibt unverändert.

5. Umgebungsvariablen ersetzen

   In ~/.zshrc/~/.bashrc und .env-Dateien: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Starten Sie das Terminal neu.

6. Installation überprüfen

   agy doctor – alle vier Punkte (Binärdatei, Authentifizierung, Plugins, Netzwerk) sollten grün sein.

7. Eine Testaufgabe ausführen

   agy "Schreibe eine README-Datei für das Projekt im aktuellen Ordner" – prüfen Sie, ob das Ergebnis dem von Gemini CLI ähnelt.

8. GitHub Actions / GitLab CI aktualisieren

   Ändern Sie den Befehlsnamen und die Secrets von GEMINI_* zu AV_*.

9. .gemini/ als Sicherung behalten

   Sie können den Ordner 1–2 Wochen nach der Bestätigung, dass alles funktioniert, löschen.

Und zum Schluss: Der 18. Juni bedeutet nicht, dass „alle Ihre Projekte ausfallen“. Es bedeutet, dass der kostenlose Zugangskanal deaktiviert wird. Der kostenpflichtige Cloud-API-Zugriff bleibt bestehen, ebenso das Gemini-CLI-Repository; Forks sind möglich. Wenn Sie den Free-Tarif genutzt haben, müssen Sie sich vor dem 18. Juni entscheiden. Andernfalls gibt der nächste Aufruf von gemini "etwas" einen Autorisierungsfehler zurück.