Antigravity CLI (agy): Einstellungen und alle Berechtigungen erlauben

Die Google Antigravity CLI (agy) führt den Coding-Agenten von Antigravity in Ihrem Terminal unter macOS, Linux, Googlebook und Windows aus. Sie konfigurieren sie mit Slash-Befehlen wie /config und /permissions oder in ~/.gemini/antigravity-cli/settings.json. Um alle Berechtigungen ohne Rückfragen zu erlauben, starten Sie agy --dangerously-skip-permissions, setzen Sie "toolPermission": "always-proceed" oder fügen Sie Platzhalter-Regeln für allow wie command(*) hinzu.

Die Antigravity CLI (agy) installieren und starten

Installieren Sie die Antigravity CLI (agy, v1.2+) mit dem Installationsprogramm für Ihr Betriebssystem.

Unter macOS, Linux und Googlebook führen Sie Folgendes aus:

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

Das Installationsprogramm legt die Binärdatei standardmäßig unter ~/.local/bin/agy ab.

Unter Windows in PowerShell führen Sie Folgendes aus:

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

Unter Windows in der Eingabeaufforderung (CMD) führen Sie Folgendes aus:

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

Beide Windows-Installationsprogramme legen die Binärdatei standardmäßig unter C:\Users\<username>\AppData\Local\agy\bin ab. Öffnen Sie ein Terminal und prüfen Sie die Installation:

agy --version

Beim ersten Start werden Sie gebeten, drei Dinge einzurichten:

• Farbschema: Wählen Sie Dark, Solarized Dark, Solarized Light oder die Standardeinstellung Ihres Terminals.
• Rendering-Modus: Wählen Sie Alt-Screen mode für einen Vollbildpuffer oder Inline mode für die Ausgabe im Terminalverlauf.
• Arbeitsbereich-Vertrauen: Bestätigen Sie, dass Sie dem Repository-Verzeichnis vertrauen, bevor der Agent mit der Dateiindizierung beginnt.

Häufige CLI-Befehle, Start-Flags und Slash-Befehle

Führen Sie agy in einem Projektverzeichnis aus, um eine interaktive Sitzung zu starten. Flags ändern das Startverhalten:

Die Antigravity CLI mit /config und settings.json konfigurieren

Die CLI speichert dauerhafte Einstellungen in ~/.gemini/antigravity-cli/settings.json, und jeder ausgelassene Schlüssel verwendet seinen Standardwert.

{
  "agentMode": "accept-edits",
  "toolPermission": "strict",
  "notifications": true
}

Wie die Einstellungsdatei funktioniert:

• Schema-Validierung: Fügen Sie "$schema": "https://antigravity.google/schemas/v1/settings.json" am Anfang der Datei für Autovervollständigung und Validierung in Editoren wie VS Code hinzu.
• Einstellungsfenster: Führen Sie /config oder den Alias /settings aus, um den Einstellungs-Editor zu öffnen, ändern Sie Optionen mit den Pfeiltasten und drücken Sie Esc zum Schließen.
• Konto-Telemetrie: Enable Telemetry in /config hat keinen Schlüssel in settings.json, da die CLI diese Auswahl in Ihrem Konto speichert.

Andere Einstellungen befinden sich in eigenen Dateien:

• Tastaturkürzel: Führen Sie /keybindings aus, um den Editor für Tastaturkürzel zu öffnen und Kürzel in ~/.gemini/antigravity-cli/keybindings.json anzupassen.
• Berechtigungsverwaltung: Führen Sie /permissions aus, um action(target)-Regeln in den Bereichen Project, Shared und Global anzuzeigen, hinzuzufügen, zu bearbeiten und zu löschen.
• MCP und Plugins: Führen Sie /mcp aus, um die Serververwaltung für das Model Context Protocol zu öffnen, oder /plugin, um Plugins zu verwalten.
• Skript-Hooks: Führen Sie /hooks im Eingabefeld aus, um aktive Pre-Flight- und Post-Format-Skript-Hooks zu durchsuchen.

Wichtige Optionen in settings.json

Ausführungsmodi und Tool-Berechtigungen

Zwei Einstellungen bestimmen, wie oft der Agent anhält, um Sie zu fragen: der Ausführungsmodus und toolPermission. Deny-Regeln blockieren eine Aktion weiterhin in jedem Modus.

Stellen Sie den Modus mit agentMode in settings.json ein, für eine Sitzung mit --mode, oder wechseln Sie die Modi mit Shift + Tab:

• default (agentMode nicht gesetzt): bittet Sie, Diffs zu prüfen, bevor Dateien geändert werden.
• accept-edits: genehmigt Änderungen und Neuerstellungen von Dateien im Arbeitsbereich automatisch.
• auto: genehmigt Änderungen im Arbeitsbereich, führt Befehle standardmäßig in der Terminal-Sandbox aus und startet sichere, umkehrbare Befehle ohne Nachfrage.
• Voraussetzungen für auto: erfordert CLI v1.3.5+ unter macOS und Linux oder v1.4.4+ unter Windows, die Terminal-Sandbox und ein persönliches Konto.
• plan: ergänzt /plan, sodass der Agent die Codebasis analysiert und einen Plan entwirft, bevor er Änderungen vornimmt.

toolPermission legt fest, wann der Agent vor der Ausführung eines Tools nachfragt:

• request-review (Standard): fragt vor dem Ausführen von Schreib-, Bash-, Web- oder MCP-Tools nach.
• proceed-in-sandbox: führt Terminalbefehle ohne Nachfrage aus, wenn der Sandbox-Modus aktiviert ist und der Befehl in der Terminal-Sandbox läuft.
• strict: fragt vor jeder Tool-Aktion nach, einschließlich des Lesens von Dateien, selbst wenn eine Allow-Regel zutrifft, und hat Vorrang vor dem auto-Modus.
• always-proceed: führt Befehle, Webanfragen und MCP-Tools ohne Nachfrage aus, sofern keine ask- oder deny-Regel zutrifft, und überschreibt den auto-Modus.

Alle Berechtigungen und Befehle in agy erlauben

Es gibt mehrere Möglichkeiten, die manuelle Bestätigung zu überspringen:

• Alle Berechtigungsabfragen für eine Sitzung überspringen: Starten Sie agy --dangerously-skip-permissions, um alle Tool-Berechtigungsanfragen automatisch zu genehmigen.
• always-proceed festlegen: Setzen Sie "toolPermission": "always-proceed" in settings.json, damit Befehle, Webanfragen und MCP-Tools ausgeführt werden, sofern keine ask- oder deny-Regel zutrifft.
• Auch Datei- und Artefakt-Prüfungen überspringen: Fügen Sie "agentMode": "accept-edits" und "artifactReviewPolicy": "always-proceed" zu settings.json hinzu:

{
  "agentMode": "accept-edits",
  "toolPermission": "always-proceed",
  "artifactReviewPolicy": "always-proceed"
}

• Alle Befehle mit einer Platzhalter-Regel erlauben: Fügen Sie command(*) über settings.json oder /permissions zur allow-Liste hinzu und lassen Sie es aus ask und deny heraus.
• Den auto-Modus verwenden: Starten Sie agy --mode=auto oder setzen Sie "agentMode": "auto", damit Bearbeitungen im Arbeitsbereich und sichere, umkehrbare Befehle ohne Nachfrage ausgeführt werden.
• Turbo in der Antigravity-App verwenden: Wählen Sie in der Desktop-App Turbo unter Settings > General > Global Permissions > Permission Preset, um die Sandbox zu deaktivieren und alle Aktionen zu erlauben.

Berechtigungsregeln: allow, ask und deny

Regeln nutzen das Format action(target) in den Listen allow, ask und deny unter permissions in settings.json. Diese Listen befinden sich in Ihrer globalen Einstellungsdatei. Konflikte folgen einer strikten Rangfolge: Deny, dann Ask, dann Allow. Mit command(*) in ask und command(git) in allow wird somit weiterhin bei jedem Befehl nachgefragt.

Wie Regeln angewendet werden:

• Globale Platzhalter: * entspricht jedem Ziel für eine Aktion, beispielsweise read_file(*), command(*) oder mcp(*).
• Befehlspräfixe und Regex: command-Regeln vergleichen standardmäßig wortweise Präfixe exakt oder werten reguläre Ausdrücke aus, wenn das Ziel mit regex: beginnt.
• Implizierte Regeln: Das Erlauben von write_file auf einem Pfad erlaubt dort auch read_file, und das Verweigern von read_file auf einem Pfad blockiert auch write_file.
• Windows-Pfade: Laufwerksbuchstaben wie C: werden entfernt und Backslashes vor der Regelprüfung in Schrägstriche (Forward Slashes) umgewandelt.
• Befehlsabgleich unter Windows: In PowerShell oder der Eingabeaufforderung benötigen Befehle, die sich nicht sauber in Wörter zerlegen lassen, eine exakte Übereinstimmung oder eine regex:-Regel wie command(regex:git .*).
• Bearbeitung an der Abfrage: Bevor Sie Allow auf einer Abfragekarte für eine Datei, URL oder ein MCP-Tool bestätigen, können Sie die Zielzeichenfolge bearbeiten, um ihren Geltungsbereich für den Turn zu erweitern.

{
  "permissions": {
    "allow": [
      "command(git)",
      "command(regex:npm run (build|lint|test))",
      "read_file(/var/log/app)",
      "write_file(src/)",
      "read_url(google.com)",
      "mcp(linter/*)"
    ],
    "deny": [
      "command(rm -rf)",
      "command(regex:curl .*)",
      "command(sudo)",
      "write_file(.git/)",
      "write_file(/home/user/.ssh)"
    ],
    "ask": ["command(*)", "execute_url(aws.amazon.com)", "mcp(sql/execute_mutation)"]
  }
}

Regeln interaktiv mit /permissions verwalten

Geben Sie /permissions in das Eingabefeld ein und drücken Sie Enter, um die Berechtigungsverwaltung zu öffnen:

• Bereichsauswahl: Wählen Sie mit den Pfeiltasten oder J und K zwischen Project, Shared oder Global und drücken Sie dann Enter.
• Regelansicht: Wechseln Sie mit der linken und rechten Pfeiltaste oder Tab zwischen den Registern allowlist, denylist und asklist.
• Regel hinzufügen: Drücken Sie A, geben Sie eine Regel im Format action(target) wie command(git) ein und drücken Sie Enter, um sie zu prüfen und zu speichern.
• Regel bearbeiten oder löschen: Markieren Sie eine Regel und drücken Sie E oder Ctrl + G zum Bearbeiten oder D bzw. Backspace zum Löschen.

Benachrichtigungen, Tool-Bestätigungen und Tastaturkürzel

Die Einstellung notifications ist standardmäßig deaktiviert. Aktivieren Sie sie, damit die CLI das Terminal-Glockensignal auslöst und eine Desktop-Benachrichtigung anzeigt, wenn der Agent eine Bestätigung oder Antwort benötigt oder seinen Turn beendet.

Im Standardmodus pausiert die CLI, bevor sie Dateien ändert oder Befehle ausführt. Mit diesen Tasten beantworten Sie die Abfragen:

Zur Verwaltung von Hintergrund-Subagenten mit /agents, dem Wechsel zu und der Bestätigung von wartenden Subagenten mit Alt+J und Strg+K sowie der Ausführung von Multi-Agent-Teams mit /teamwork siehe Google Antigravity multi-agent: run parallel coding agents.

Wenn Sie auch den eigenständigen Editor nutzen, siehe Google Antigravity IDE: editor, agents and permissions dazu, wie er globale Hooks teilt und den Strict-Modus, Terminal-Sandboxing sowie Artefakt-Reviews einrichtet.

Um Datenbanken, Dokumentationen und externe APIs mit /mcp oder mcp_config.json anzubinden, siehe Google Antigravity MCP servers: set up and manage tools.

Zur Installation der CLI in PowerShell oder der Eingabeaufforderung, dem Festlegen Ihres Windows-PATH und dem Aktivieren der AppContainer-Sandbox siehe Google Antigravity on Windows: install, CLI and setup.

Antigravity-Sitzungen auf einem Keypad oder Smartphone mit Orbtile überwachen

Orbtile zeigt Ihre Coding-Agenten auf einem Logitech MX Creative Keypad oder auf einem iPhone (iOS 17+) bzw. Android-Smartphone (Android 8.0+) mit Orbtile Mobile an. Es läuft auf einem Computer mit macOS 14.0 Sonoma oder neuer auf Apple Silicon oder unter Windows 11 (x64).

• Antigravity-Desktop-App: Orbtile folgt Unterhaltungen in der Antigravity-Desktop-App und weist jeder eine Taste mit Titel, Status und Live-Antworttext zu.
• Wartende Fragen zuerst: Eine Unterhaltung, die auf eine Frage wartet, rückt nach vorne und nutzt ab Orbtile 0.3.4 die gemeinsame Terrakotta-Alarmfarbe.
• Über die Tasten antworten: Sie können bis zu vier Fragen mit nummerierten Optionen und jeweils zwei bis vier Auswahlmöglichkeiten über das Keypad beantworten.
• Verbleibt auf Ihrem Computer: Berechtigungsabfragen und schriftliche Antworten bleiben auf Ihrem Computer.
• Antigravity CLI und IDE: CLI- und IDE-Sitzungen erscheinen nicht automatisch, aber ein CLI-Hook-Skript kann jede Sitzung an die lokale Adapter-API von Orbtile melden.
• Adapter-API aktivieren: Öffnen Sie in Orbtile Settings > Agents, wählen Sie Build your own, aktivieren Sie Let your own tools show sessions und erlauben Sie Ihren Adapter.
• Jeder Agent auf einem Pad: Dasselbe Keypad oder Smartphone zeigt auch Sitzungen von Claude Code, Codex, ZCode und Kimi Code sowie Remote-Sitzungen über SSH an.

Siehe Antigravity-Benachrichtigungen: Wissen, wann ein Agent wartet und Show any script or agent on a keypad with the Orbtile Adapter API.