Référence des commandes · Antigravity CLI
@<chemin>
Ouvre un overlay interactif de sélection de chemin de fichier directement dans la saisie du prompt.
Taper @ dans la zone de prompt ouvre l'overlay « Interactive Path Suggestion » : elle parcourt les chemins de fichiers de l'espace de travail et insère le chemin absolu choisi directement dans le prompt. Selon les recommandations de bonnes pratiques de la documentation de la CLI, ces ancres de contexte servent à délimiter plus précisément les limites de raisonnement de l'agent et à éviter une surcharge de tokens inutile, plutôt que de taper les chemins manuellement ou de compter sur une reconnaissance libre du texte. En particulier dans les grands dépôts contenant plusieurs fichiers portant le même nom (par exemple plusieurs index.ts), le chemin absolu inséré garantit que l'agent référence exactement le fichier visé.
Avant la version 1.0.6, @ ne déclenchait les suggestions que s'il était immédiatement précédé d'un espace ; depuis la correction en version 1.0.6, @ se déclenche sans condition, même juste après une parenthèse ouvrante ( ou au milieu d'un mot. L'overlay est purement additif par rapport à la saisie de texte : il n'exécute rien et ne remplace aucun texte existant dans le prompt.
✅ QUAND L’UTILISER ?
Référencer précisément un fichier donné, sans taper le chemin manuellement
taper @src/auth/ pour naviguer vers le fichier souhaité dans l'overlay
Donner directement un fichier comme contexte à l'agent dans une question
Explique-moi la logique dans @src/utils/formatter.ts
⛔ QUAND ÉVITER ?
Une commande de terminal doit être exécutée directement
@ ne fait qu'insérer un chemin de fichier dans le prompt, sans rien exécuter.
Mieux: utiliser ! en début de ligne pour les commandes de terminal directes
Une commande slash doit être déclenchée
@ n'ouvre que l'overlay de chemin, pas de liste de commandes.
Mieux: taper / en début de ligne pour ouvrir le menu des commandes slash
SOURCES
- doc Antigravity CLI : Best Practices ↗ antigravity.google
- doc Antigravity CLI : Using the CLI ↗ antigravity.google