OpenCode integration

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

Open sync dialog

Navigate to API Proxy → External Providers
Click the OpenCode Sync card

Click Sync button

Antigravity will automatically:

Generate ~/.config/opencode/opencode.json
Create antigravity-manager provider
Preserve existing Google/Anthropic providers

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:

Open settings

In the OpenCode Sync dialog, find Custom Manager BaseURL

Enter URL

http://your-server:8045

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
Balanced
Cost-effective

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

Routes to Pro/Ultra tier accounts with maximum quota.

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

Uses standard Pro tier accounts.

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:

Set Custom Manager BaseURL: http://antigravity:8045
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 foundSolutions:

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

Connection refused

Problem: ECONNREFUSED when calling modelsSolutions:

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

Thinking budget errors

Problem: AI_UnsupportedFunctionalityError: 'thinking requires a budget'Solutions:

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

Model not available

Problem: Model listed but returns 404Solutions:

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

Best practices

Use automatic sync: Let Antigravity manage the configuration
Multiple providers: Keep both antigravity-manager and native providers for flexibility
Environment-specific URLs: Use custom URLs for dev/staging/production
Regular updates: Re-sync after adding new models or accounts
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": "[email protected]",
      "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

Getting Started

Core Features

Integration Guides

Configuration

Deployment

Troubleshooting

Overview

Prerequisites

Configuration sync

Provider configuration

Custom base URL

Usage examples

Basic usage

Model variants

Thinking models

Configuration management

Clear configuration

Restore from backup

Manual configuration

Docker/remote deployment

Docker Compose setup

Remote server

Troubleshooting

Best practices

Advanced features

Account export

Coexisting with native providers

Build docs developers (and LLMs) love

Getting Started

Core Features

Integration Guides

Configuration

Deployment

Troubleshooting

​Overview

​Prerequisites

​Configuration sync

​Provider configuration

​Custom base URL

​Usage examples

​Basic usage

​Model variants

​Thinking models

​Configuration management

​Clear configuration

​Restore from backup

​Manual configuration

​Docker/remote deployment

​Docker Compose setup

​Remote server

​Troubleshooting

​Best practices

​Advanced features

​Account export

​Coexisting with native providers

​Related documentation

Build docs developers (and LLMs) love

Overview

Prerequisites

Configuration sync

Provider configuration

Custom base URL

Usage examples

Basic usage

Model variants

Thinking models

Configuration management

Clear configuration

Restore from backup

Manual configuration

Docker/remote deployment

Docker Compose setup

Remote server

Troubleshooting

Best practices

Advanced features

Account export

Coexisting with native providers

Related documentation