agy --sandbox

Erzwingt Sandbox-Isolation für Terminal-Befehle, auch im Print-Modus.

agy --sandbox schränkt alle vom Agent gestarteten lokalen Ausführungsbefehle auf Betriebssystem-Containment-Mechanismen ein: nsjail (Linux, kernel namespaces/cgroups), sandbox-exec (macOS, Policy-Profile) bzw. AppContainer (Windows). Seit 1.0.6 wird das Flag korrekt auch im nicht-interaktiven Print-Modus (-p/--print) durchgesetzt, nicht nur interaktiv. Dieselbe Einstellung lässt sich dauerhaft über enableTerminalSandbox in settings.json setzen (Default: false).

✅ WANN EINSETZEN?

Nicht vertrauenswürdigen oder generierten Code isoliert ausführen lassen

agy --sandbox in einem neuen/unbekannten Repo starten

Auch im Skript-/CI-Kontext Sandbox-Isolation erzwingen

agy --sandbox -p "<prompt>"

⛔ WANN EHER NICHT?

Der Agent braucht vollen Zugriff auf Systemressourcen außerhalb des Workspace

Die Sandbox schränkt Dateisystem-Sichtbarkeit und Netzwerkzugriff der Terminal-Befehle bewusst ein.

Besser: agy ohne --sandbox starten oder pro Befehl die Option 'ohne Sandbox ausführen' bestätigen

QUELLEN

Antigravity CLI CHANGELOG (GitHub) ↗ raw.githubusercontent.com
Antigravity CLI Doku: Sandbox ↗ antigravity.google