Command reference ยท Antigravity CLI
@<path>
Opens an interactive overlay for picking a file path right in the prompt box.
Typing @ in the prompt box opens the "Interactive Path Suggestion" overlay: it searches file paths in the workspace and inserts the chosen absolute path directly into the prompt. According to the best-practice recommendations in the CLI docs, such context anchors serve to more precisely narrow the agent's reasoning scope and avoid unnecessary token overhead, instead of typing paths manually or relying on free text recognition. Especially in larger repositories with several identically named files (for example several index.ts), the inserted absolute path ensures that the agent references exactly the intended file.
Before version 1.0.6, @ only triggered the suggestions if a space immediately preceded it; since the fix in version 1.0.6, @ triggers unconditionally, even directly after an opening parenthesis ( or in the middle of a word. The overlay is purely additive to text input: it doesn't execute anything and doesn't replace existing text in the prompt.
โ WHEN TO USE IT?
Reference a specific file directly, without typing the path manually
Type @src/auth/ to navigate to the matching file in the overlay
Give the agent a file directly as context within a question
Explain the logic in @src/utils/formatter.ts
โ WHEN NOT TO?
A terminal command should be executed directly
@ only inserts a file path into the prompt, but doesn't execute anything.
Better: Use ! at the start of a line for direct terminal commands
A slash command should be triggered
@ only opens the path overlay, not a command list.
Better: Type / at the start of a line to open the slash command menu
SOURCES
- Antigravity CLI docs: Best Practices โ antigravity.google
- Antigravity CLI docs: Using the CLI โ antigravity.google