Befehls-Referenz · Antigravity CLI
@<pfad>
Öffnet ein interaktives Overlay zur Dateipfad-Auswahl direkt in der Prompt-Eingabe.
Tippt man @ in der Prompt-Box, öffnet sich die "Interactive Path Suggestion"-Overlay: Sie durchsucht Dateipfade im Workspace und fügt den gewählten absoluten Pfad direkt in den Prompt ein. Laut den Best-Practice-Empfehlungen der CLI-Doku dienen solche Kontext-Anker dazu, die Reasoning-Grenzen des Agenten präziser einzugrenzen und unnötigen Token-Overhead zu vermeiden, statt Pfade manuell abzutippen oder auf freie Texterkennung zu vertrauen. Gerade in größeren Repositories mit mehreren gleich benannten Dateien (etwa mehreren index.ts) stellt der eingefügte absolute Pfad sicher, dass der Agent exakt die gemeinte Datei referenziert.
Vor Version 1.0.6 löste @ die Vorschläge nur aus, wenn unmittelbar davor ein Leerzeichen stand; seit dem Fix in Version 1.0.6 triggert @ unconditional, auch direkt nach einer öffnenden Klammer ( oder mitten im Wort. Das Overlay ist rein additiv zur Texteingabe: Es führt nichts aus und ersetzt keinen bestehenden Text im Prompt.
✅ WANN EINSETZEN?
Eine bestimmte Datei gezielt referenzieren, ohne den Pfad manuell abzutippen
@src/auth/ tippen, um im Overlay zur passenden Datei zu navigieren
Dem Agenten in einer Frage direkt eine Datei als Kontext mitgeben
Erkläre mir die Logik in @src/utils/formatter.ts
⛔ WANN EHER NICHT?
Ein Terminal-Befehl soll direkt ausgeführt werden
@ fügt nur einen Dateipfad in den Prompt ein, führt aber nichts aus.
Besser: ! am Zeilenanfang für direkte Terminal-Befehle nutzen
Ein Slash-Befehl soll ausgelöst werden
@ öffnet ausschließlich die Pfad-Overlay, keine Befehlsliste.
Besser: / am Zeilenanfang tippen, um das Slash-Command-Menü zu öffnen
QUELLEN
- Antigravity CLI Doku: Best Practices ↗ antigravity.google
- Antigravity CLI Doku: Using the CLI ↗ antigravity.google