OpenCode integration

Integrate Antigravity Manager with OpenCode for seamless AI-powered development

Overview

Antigravity Manager provides first-class integration with OpenCode through automatic configuration sync and provider management.

OpenCode integration was significantly enhanced in v4.1.16 with support for custom base URLs and environment variable-based configuration.

Prerequisites

• Antigravity Manager installed and configured
• OpenCode installed (npm install -g opencode)
• At least one active account in Antigravity

Configuration sync

1. Open sync dialog

   1. Navigate to API Proxy → External Providers
   2. Click the OpenCode Sync card
2. Click Sync button

   Antigravity will automatically:

   • Generate ~/.config/opencode/opencode.json
   • Create antigravity-manager provider
   • Preserve existing Google/Anthropic providers
3. Optional: Sync accounts

   Check Sync accounts to export:

   • antigravity-accounts.json (plugin-compatible v3 format)
   • Allows OpenCode plugin to import accounts directly

Windows users: Configuration path is C:\Users\<username>\.config\opencode\

Provider configuration

The sync creates an antigravity-manager provider with these properties:

{
  "providers": {
    "antigravity-manager": {
      "baseURL": "http://127.0.0.1:8045",
      "apiKey": "sk-antigravity",
      "models": [
        "claude-sonnet-4-6",
        "claude-sonnet-4-6-thinking",
        "gemini-3-flash",
        "gemini-3-pro-high"
      ]
    }
  }
}

Custom base URL

For Docker or remote deployments, set a custom base URL:

1. Open settings

   In the OpenCode Sync dialog, find Custom Manager BaseURL

2. Enter URL

   http://your-server:8045
   
3. Sync configuration

   Click Sync to apply the custom URL

Usage examples

Basic usage

# Test the antigravity-manager provider
opencode run "test" --model antigravity-manager/claude-sonnet-4-6

# Use with variant (high/max/low)
opencode run "test" --model antigravity-manager/claude-sonnet-4-6-thinking --variant high

Model variants

Antigravity supports OpenCode’s variant system:

High performance

opencode run "complex task" \
  --model antigravity-manager/gemini-3-pro-high \
  --variant max

Routes to Pro/Ultra tier accounts with maximum quota.

Balanced

opencode run "moderate task" \
  --model antigravity-manager/claude-sonnet-4-6 \
  --variant medium

Uses standard Pro tier accounts.

Cost-effective

opencode run "simple task" \
  --model antigravity-manager/gemini-3-flash \
  --variant low

Prefers free/low-tier accounts.

Thinking models

# Extended thinking with budget
opencode run "analyze this codebase" \
  --model antigravity-manager/claude-sonnet-4-6-thinking

# Thinking with variant
opencode run "complex problem" \
  --model antigravity-manager/claude-opus-4-6-thinking \
  --variant high

Antigravity automatically handles thinking budget conversion between OpenCode’s format and Gemini’s internal format.

Configuration management

Clear configuration

Remove Antigravity configuration and legacy entries:

# In OpenCode Sync dialog, click "Clear Config"

This removes:

• antigravity-manager provider
• Legacy plugin configurations
• Temporary sync files

Restore from backup

If sync creates issues:

# In OpenCode Sync dialog, click "Restore"

Restores the previous opencode.json from automatic backup.

Manual configuration

You can also edit ~/.config/opencode/opencode.json directly:

{
  "providers": {
    "antigravity-manager": {
      "baseURL": "http://127.0.0.1:8045",
      "apiKey": "sk-your-api-key",
      "defaultModel": "claude-sonnet-4-6",
      "models": [
        "claude-sonnet-4-6",
        "claude-sonnet-4-6-thinking",
        "gemini-3-flash",
        "gemini-3-pro-high"
      ]
    }
  }
}

Docker/remote deployment

Docker Compose setup

For Docker Compose networks:

services:
  antigravity:
    image: lbjlaq/antigravity-manager:latest
    ports:
      - "8045:8045"
    environment:
      - API_KEY=sk-your-key

In OpenCode sync:

1. Set Custom Manager BaseURL: http://antigravity:8045
2. Sync configuration

Remote server

For servers on different machines:

# Set custom URL to remote server
Custom Manager BaseURL: http://192.168.1.100:8045

Ensure the Antigravity proxy is configured to allow LAN access:

• Enable Allow LAN Access in API Proxy settings
• Or set ABV_BIND_LOCAL_ONLY=false for Docker

Troubleshooting

Provider not found

Problem: Error: Provider 'antigravity-manager' not found

Solutions:

1. Verify sync completed successfully
2. Check file exists: ~/.config/opencode/opencode.json
3. Run sync again from Antigravity UI
4. Verify JSON syntax is valid

Connection refused

Problem: ECONNREFUSED when calling models

Solutions:

1. Verify Antigravity proxy is running
2. Check base URL matches actual server address
3. For Docker: use container name, not localhost
4. Test with: curl http://127.0.0.1:8045/health

Thinking budget errors

Problem: AI_UnsupportedFunctionalityError: 'thinking requires a budget'

Solutions:

1. Upgrade to Antigravity v4.1.27 or later
2. Verify thinking model names include -thinking suffix
3. Check account supports thinking-capable models
4. Review Antigravity logs for conversion details

Model not available

Problem: Model listed but returns 404

Solutions:

1. Check model is available in Antigravity dashboard
2. Refresh account quotas in Antigravity
3. Verify model name spelling (case-sensitive)
4. Check custom model mappings in Antigravity

Best practices

1. Use automatic sync: Let Antigravity manage the configuration
2. Multiple providers: Keep both antigravity-manager and native providers for flexibility
3. Environment-specific URLs: Use custom URLs for dev/staging/production
4. Regular updates: Re-sync after adding new models or accounts
5. Backup configs: Antigravity creates automatic backups before each sync

Advanced features

Account export

When Sync accounts is enabled, Antigravity exports:

// ~/.config/opencode/antigravity-accounts.json
{
  "accounts": [
    {
      "email": "[e-mail]",
      "tier": "pro",
      "quota": {
        "gemini-3-flash": 0.85,
        "gemini-3-pro-high": 0.42
      }
    }
  ]
}

This allows OpenCode plugins to:

• Display account information
• Show quota status
• Enable account-specific features

Coexisting with native providers

Antigravity sync preserves existing providers:

{
  "providers": {
    "google": {
      "apiKey": "your-google-key"
    },
    "anthropic": {
      "apiKey": "your-anthropic-key"
    },
    "antigravity-manager": {
      "baseURL": "http://127.0.0.1:8045"
    }
  }
}

Use whichever fits your needs:

# Direct Google API
opencode run "task" --model google/gemini-3-flash

# Through Antigravity (with rotation)
opencode run "task" --model antigravity-manager/gemini-3-flash

Related documentation

• OpenCode Sync implementation
• API Proxy settings
• Model routing
• Docker deployment