Command reference ยท Antigravity CLI
agy --mode <default|accept-edits|plan>
Sets the agent execution mode at startup.
agy --mode=<default|accept-edits|plan> sets the agent execution mode at startup (publicly available since version 1.1.0). default (= request-review) pauses before every file write and shows a line-by-line diff preview to confirm (y), reject (n), or fully review (f). accept-edits applies all standard file operations (write_to_file, replace_file_content, multi_replace_file_content) automatically, even with subagents running in parallel. plan automatically prepends the /plan prefix to every prompt: the agent then first researches using only read tools and proposes an execution plan before writing code.
Without the flag, the default mode last set via /settings ("Agent Mode" option) or in settings.json under agentMode applies. During the session, you can cycle through the three modes independently of the startup flag using Shift+Tab (default โ accept-edits โ plan โ default). Regardless of the chosen mode, rules configured via /permissions or --dangerously-skip-permissions for shell commands (run_command) remain decisive.
โ WHEN TO USE IT?
Start directly in the lower-risk review mode
agy --mode=default
Start directly in auto-accept mode for fast prototyping
agy --mode=accept-edits
โ WHEN NOT TO?
Expecting the deprecated /planning or /fast commands
Both slash commands were removed in version 1.1.0 and replaced by the three --mode values.
Better: Use Shift+Tab to cycle through modes, or put /plan before the prompt
Using --permission-mode as the flag name
This flag does not exist; the CLI uses --mode exclusively for execution modes.
Better: Use agy --mode=accept-edits (or agy --help to look it up)
SOURCES
- Antigravity CLI CHANGELOG (GitHub) โ raw.githubusercontent.com