Antigravity CLI (agy) auf einem Server

Seit dem 18. Juni 2026 bedient Gemini CLI keine privaten Konten mit kostenloser Stufe, Google AI Pro oder Ultra mehr. Googles Ankündigung verweist diese Nutzer auf die Antigravity CLI, agy. Auf einem Server brauchen drei Dinge Sorgfalt: die Anmeldung ohne Browser, die Wahl zwischen Google-Anmeldung und API-Schlüssel und das Wissen, wie agy mit Berechtigungen umgeht, wenn niemand am Terminal sitzt. Hier der Reihe nach.

agy installieren

Unter Linux oder macOS, als dein normaler Benutzer (nicht root):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

Laut offizieller Installationsseite landet das Binary in ~/.local/bin/agy; genannt werden macOS, Linux und Windows. Der Installer holt einen Build pro Plattform, mit Linux-Builds für amd64 und arm64, ein ARM-VPS ist also kein Problem. Trag die PATH-Zeile in ~/.bashrc oder ~/.profile ein, damit neue Shells und tmux-Fenster sie übernehmen.

Eine Gewohnheit speziell für Server: agy aktualisiert sich im Hintergrund selbst. Auf einem Laptop ist das bequem. Auf einem Rechner, den du durchlaufen lässt, heißt das, dass sich die Version unter einer langen Session ändern kann. Maude pinnt die Version, die es installiert, und schaltet das mit AGY_CLI_DISABLE_AUTO_UPDATE=1 ab. Willst du dieselbe Vorhersehbarkeit, exportiere diese Variable in der Shell oder Unit, die agy startet.

Anmeldung per SSH

Starte agy in einer SSH-Session und wähle die Google-Anmeldung. Auf einem Laptop würde sich ein Browser öffnen. Per SSH erkennt es die entfernte Session und gibt stattdessen eine Autorisierungs-URL aus. Dann:

1. Kopier die URL und öffne sie auf deinem Handy oder Laptop.
2. Melde dich mit dem Google-Konto an, das du für Antigravity nutzt.
3. Kopier den Code, den die Seite dir gibt, und füg ihn wieder ins Terminal ein.

Zugangsdaten werden im Schlüsselbund des Betriebssystems gespeichert, unter Linux im Secret Service. Ein nackter VPS hat keine Desktop-Session, die einen Schlüsselbund entsperren könnte. Ein GitHub-Issue zu agy 1.0.0 meldet genau deshalb eine Anmeldeschleife auf Headless-Linux, dazu einen Zeitzonen-Bug im Datei-Fallback. Der Workaround des Meldenden war GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Ob aktuelle Versionen das noch brauchen, haben wir nicht bestätigt. Fragt agy dich bei jedem Start erneut nach der Anmeldung, ist dieses Issue die erste Anlaufstelle. Ansonsten nimm den API-Schlüssel-Modus.

Zum Abmelden und Löschen des gespeicherten Profils führst du /logout in agy aus.

API-Schlüssel-Modus für headless

Für CI, einen geteilten Rechner oder jeden Server, auf dem du lieber keine Google-Session vorhalten willst, betreibst du agy mit einem Gemini-API-Schlüssel. Die Installationsdoku nennt zwei Schritte. Setz zuerst den Modell-Provider in ~/.gemini/antigravity-cli/settings.json. Existiert die Datei schon, füg es dort ein:

{
  "modelProvider": "gemini"
}

Stell dann den Schlüssel für den Prozess bereit:

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

Damit entfällt die Kontoanmeldung komplett. Die Nutzung wird pro Token nach den Preisen der Gemini API abgerechnet, statt gegen ein Google-AI-Abo zu zählen. Halte den Schlüssel aus der Shell-Historie und aus dem Repository heraus, in dem der Agent arbeitet.

Berechtigungen, wenn niemand zuschaut

Das ist das Server-Verhalten, das am meisten überrascht. In unseren Tests mit agy 1.2.14 gilt: Headless-Läufe (agy -p … oder der stream-json-Modus) können nicht anhalten und fragen, bevor ein Tool läuft. Ein Befehl oder Dateischreibvorgang, der eine Berechtigung braucht, wird abgelehnt, und das Ergebnis des Turns führt ihn als abgelehnt auf. Du hast drei Wege, Arbeit durchzulassen:

• Erlaubnisregeln. agy liest sie aus permissions.allow in ~/.gemini/antigravity-cli/settings.json. Einträge sehen aus wie "command(npm test)", "write_file(src/app.ts)" oder "command(*)". Sie werden beim Start gelesen.
• Modi. --mode accept-edits genehmigt Dateiänderungen automatisch, Befehle werden aber weiterhin abgelehnt. --mode plan plant, ohne zu handeln.
• Gar keine Prüfungen. --dangerously-skip-permissions, für einen Wegwerf-Rechner. Lies Agenten sicher mit vollen Berechtigungen betreiben, bevor du dazu greifst.

Interaktives agy im Terminal und Remote Control (siehe unten) können anhalten und fragen. Diese Einschränkung betrifft also speziell die skriptgesteuerte Headless-Nutzung.

Deine Gemini-CLI-Konfiguration mitnehmen

Die Migrationsanleitung behandelt das. Die Kurzfassung für einen Server, auf dem schon Gemini CLI lief:

• Der erste Start bietet die Migration an. Findet agy eine bestehende Gemini-CLI-Konfiguration, zeigt es eine Checkliste mit Extensions und globalen Einstellungen zum Konvertieren.
• Aus Extensions werden Plugins. Führ jederzeit agy plugin import gemini aus, um Gemini-Extensions in Antigravity-Plugins umzuwandeln.
• Kontextdateien funktionieren, wie sie sind. GEMINI.md (im Workspace und ~/.gemini/GEMINI.md) und AGENTS.md werden ohne Änderungen gelesen.
• MCP-Server brauchen eine kleine Anpassung. Globale Server liegen in ~/.gemini/config/mcp_config.json, Workspace-Server in .agents/mcp_config.json. Benenne die alten Schlüssel url/httpUrl in serverUrl um.
• Skills ziehen um. Workspace-Skills wandern von .gemini/skills/ nach .agents/skills/, globale nach ~/.gemini/antigravity-cli/skills/. Die musst du selbst verschieben.

Laut Google gibt es noch keine vollständige Funktionsparität, und die Migrationsanleitung weist darauf hin, dass manche eigenen Themes und visuellen Anpassungen nicht übernommen werden. Hängt ein Workflow an einer bestimmten Extension, teste ihn nach dem Import, bevor du das alte Setup löschst.

Remote-Control-Daemon vs. Maude

Google liefert einen offiziellen Weg, agy von einem anderen Gerät aus zu erreichen. Laut Remote-Control-Doku startest du es auf drei Arten:

• /remote-control in einer laufenden Session. Der Tunnel endet, wenn diese CLI-Session beendet wird.
• agy --remote-control beim Start einer Session. Auch dieser Tunnel endet, wenn die Session beendet wird.
• Der Headless-Daemon: agy remote-control start --name my-vps, dazu agy remote-control status und agy remote-control stop. Er registriert einen Dienst im Betriebssystem, der im Hintergrund weiterläuft.

Gesteuert wird über ein Web-Dashboard in einem beliebigen Browser, angemeldet mit demselben Google-Konto. Laut Doku kannst du das Dashboard auf dem Home-Bildschirm deines Handys installieren, um Push-Benachrichtigungen zu bekommen, und Berechtigungsanfragen entweder im Terminal oder in der Remote-Oberfläche beantworten. Außerdem heißt es dort, dass ein Feature-Flag für Konto oder Organisation es blockieren kann.

Ist Antigravity der einzige Agent, den du nutzt, und ist das Feature-Flag für dein Konto aktiv, ist der offizielle Daemon die naheliegende erste Wahl. Er ist kostenlos und kann vor dem Handeln fragen.

Vom Handy aus betreiben

Willst du agy auf einem Server neben anderen Agenten haben und aus einer nativen App steuern, ist Maude eine Option. Füge den Server hinzu, und die App installiert agy in einer getesteten Version und meldet dich vom Handy aus an – per Google-Anmeldung mit eingefügtem Code oder mit einem Gemini-API-Schlüssel. Um bei Antigravity in Maude offen zu sein: Weil Maude agy headless steuert, kann es nicht anhalten und fragen, bevor ein Tool läuft. Maude zeigt dir die abgelehnte Aktion, und wenn du freigibst, fügt es eine Erlaubnisregel hinzu und versucht es erneut. Die Details stehen auf der Agenten-Seite zu Antigravity. Die Änderung an Gemini CLI selbst und wohin andere umgestiegen sind, behandelt unser Beitrag zum Aus von Gemini CLI.

Häufige Fragen

Was sich geändert hat

• 1. Oktober 2026 — Erstveröffentlichung. Angaben zu Installation, Authentifizierung, Migration und Remote Control mit der Doku auf antigravity.google abgeglichen; Verhalten bei Berechtigungen im Headless-Modus aus unseren eigenen Tests mit agy 1.2.14.