Antigravity CLI — Configuration Reference

Antigravity CLI stores settings in JSON format and uses environment variables for auth. Here's the complete reference.

Settings File

Location: ~/.gemini/antigravity-cli/settings.json

{
  "model": "Gemini 3.5 Flash (High)",
  "enableTerminalSandbox": true,
  "toolPermission": "request-review",
  "trustedWorkspaces": ["/home/user/projects"],
  "enableTelemetry": true,
  "colorScheme": "dark"
}

Available Settings

Sandbox & Permissions

Sandboxing is controlled by two settings:

• enableTerminalSandbox — Toggles sandbox isolation on/off for shell commands
• toolPermission — How the CLI handles permission requests:
  • "request-review" — Ask for each operation (default)
  • "always-proceed" — Auto-approve (not recommended for untrusted code)
  • "strict" — Deny all non-read operations
  • "proceed-in-sandbox" — Auto-approve within sandbox, ask outside

Environment Variables

MCP Servers

Antigravity CLI supports the Model Context Protocol for connecting external tools.

Add an MCP server

agy mcp add <name> <command>
agy mcp add postgres npx @modelcontextprotocol/server-postgres

Manage MCP servers

agy mcp list          # List all servers
agy mcp remove <name> # Remove a server
agy mcp enable <name> # Enable a server
agy mcp disable <name> # Disable a server

MCP in settings.json

Servers can also be configured directly in settings.json:

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"]
    },
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"]
    }
  }
}

Plugins

Plugins extend Antigravity CLI with new tools and capabilities.

Install a plugin

agy plugin install <source>
agy plugin install https://github.com/user/antigravity-skill-library

Manage plugins

agy plugin list          # Show installed plugins
agy plugin update --all  # Update all plugins
agy plugin uninstall <name> # Remove a plugin

Project Context Files

GEMINI.md

Place at project root for persistent project context:

# Project Context

## Commands
- `npm run dev` — Start development server
- `npm run build` — Production build
- `npm test` — Run tests

## Architecture
- Next.js 15 App Router
- Tailwind CSS v4
- Supabase for database + auth
- Vitest + Playwright for testing

AGENTS.md

Used by Antigravity CLI agents for agent-specific instructions. Same format as GEMINI.md. Both files are read and merged.

.antigravityignore

Exclude files from context:

node_modules/
dist/
.env
*.log

.geminiignore is also supported as a fallback.

Trusted Workspaces

Trusted workspaces bypass sandbox restrictions for the specified directories:

{
  "trustedWorkspaces": [
    "/home/user/projects/my-app/src",
    "/home/user/projects/my-app/lib"
  ]
}

Configured in settings.json or via the CLI:

> /permissions add /home/user/projects/my-app/src
> /permissions list
> /permissions remove /home/user/projects/my-app/src

Related

• Getting Started — Install and authenticate
• Prompt Engineering — Prompt strategies
• Migration Guide — Gemini CLI → agy
• Agent Skills — Open standard for agent capabilities
• MCP Servers — Full MCP server directory