Agent Modes & Settings
FreshConversation Modes
Antigravity offers two conversation-level modes that control how the agent approaches tasks:
Planning Mode
Best for complex, multi-step work:
- Deep research and analysis
- Complex tasks requiring multiple steps
- Task groups with subtasks
- Rich artifact generation (plans, architecture diagrams, walkthroughs)
Fast Mode
Best for simple, speed-critical tasks:
- Quick edits and fixes
- Simple code generation
- Speed is the priority over depth
TIP
Switch modes at any time during a conversation. Use Planning mode when you need the agent to think deeply about architecture or multi-file changes. Use Fast mode for quick fixes.
Settings
Artifact Review Policy
| Setting | Behavior |
|---|---|
| Always Proceed | Agent applies changes without waiting for user review. |
| Request Review | Agent pauses and asks for user approval before applying artifacts. |
Terminal Command Auto Execution
Control whether the agent can run terminal commands without approval:
- Configure allow lists and deny lists for commands
- Unix/Linux/macOS: Uses prefix matching (e.g.,
npmmatchesnpm install,npm run) - PowerShell (Windows): Uses subsequence matching
WARNING
Carefully configure your allow/deny lists. Allowing broad command patterns without review can lead to unintended side effects.
Agent Non-Workspace File Access
When enabled, the agent can access files outside the current workspace directory.
WARNING
Use with caution. Enabling non-workspace file access exposes your local file system data to the agent. Only enable when you specifically need the agent to read or modify files outside the project.