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.8 Flash (High)",
  "enableTerminalSandbox": false,
  "toolPermission": "request-review",
  "permissions": {
    "allow": ["command(git diff)", "command(git status)"]
  },
  "enableTelemetry": true,
  "colorScheme": "terminal"
}

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

Sandboxing is enabled per run with --sandbox or persistently with enableTerminalSandbox; there is no ANTIGRAVITY_SANDBOX environment variable.

MCP Servers

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

Add and manage MCP servers

Type /mcp in the prompt panel to open the interactive MCP Manager. It shows connection status, reloads server configurations, and exposes live logs. There are no agy mcp shell subcommands.

Server definitions live in separate JSON files:

• Global: ~/.gemini/config/mcp_config.json
• Workspace: .agents/mcp_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/absolute/path/to/project"
      ]
    }
  }
}

The Filesystem server requires at least one allowed directory argument. The official GitHub and Postgres reference servers are archived, and their npm packages are deprecated; browse the MCP Registry for maintained alternatives.

Remote servers use serverUrl rather than url or httpUrl:

{
  "mcpServers": {
    "remote": {
      "serverUrl": "https://example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${API_TOKEN}"
      }
    }
  }
}

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 enable <name>    # Enable a plugin
agy plugin disable <name>   # Disable a plugin
agy plugin uninstall <name> # Remove a plugin
agy plugin import gemini    # Import legacy Gemini CLI extensions

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.

Permissions

Permissions are controlled by permissions.allow rules in settings.json. The CLI documents rules such as command(git), command(regex:npm run (build|lint|test)), and write_file(src/):

{
  "permissions": {
    "allow": [
      "command(git)",
      "command(regex:npm run (build|lint|test))",
      "write_file(src/)"
    ]
  }
}

Use /permissions in the TUI to review and manage the active rules. There is no trustedWorkspaces setting.

Related

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

Sources

• Antigravity CLI commands and settings
• Antigravity CLI headless permissions
• Antigravity MCP configuration
• Antigravity plugins
• Antigravity authentication
• MCP reference servers