|
|
@@ -1,157 +1,150 @@
|
|
|
-# Antigravity Provider Setup Guide
|
|
|
+# Antigravity Setup Guide
|
|
|
|
|
|
-Complete guide for configuring Antigravity provider with oh-my-opencode-slim to access Claude and Gemini models through the "google" provider configuration.
|
|
|
+## Quick Setup
|
|
|
|
|
|
-## Table of Contents
|
|
|
+1. Install with Antigravity support:
|
|
|
+ ```bash
|
|
|
+ bunx oh-my-opencode-slim install --antigravity=yes
|
|
|
+ ```
|
|
|
|
|
|
-- [Overview](#overview)
|
|
|
-- [Installation](#installation)
|
|
|
-- [Configuration](#configuration)
|
|
|
-- [Provider Setup](#provider-setup)
|
|
|
-- [Agent Model Assignment](#agent-model-assignment)
|
|
|
-- [Usage Examples](#usage-examples)
|
|
|
-- [Troubleshooting](#troubleshooting)
|
|
|
+2. Authenticate:
|
|
|
+ ```bash
|
|
|
+ opencode auth login
|
|
|
+ # Select "google" provider
|
|
|
+ ```
|
|
|
|
|
|
----
|
|
|
+3. Start using:
|
|
|
+ ```bash
|
|
|
+ opencode
|
|
|
+ ```
|
|
|
|
|
|
-## Overview
|
|
|
+## How It Works
|
|
|
|
|
|
-Antigravity provides access to high-quality Claude and Gemini models through a unified interface. This guide shows you how to configure oh-my-opencode-slim to use Antigravity via the "google" provider configuration.
|
|
|
+The installer automatically:
|
|
|
+- Adds `opencode-antigravity-auth@latest` plugin
|
|
|
+- Configures Google provider with all Antigravity and Gemini CLI models
|
|
|
+- Sets up agent mapping (Kimi/GPT for Orchestrator/Oracle, Antigravity for others)
|
|
|
|
|
|
-**Benefits:**
|
|
|
-- Access to Claude Opus 4.5 Thinking and Sonnet 4.5 Thinking models
|
|
|
-- Gemini 3 Pro High and Flash models
|
|
|
-- Unified configuration through OpenCode
|
|
|
-- Excellent for complex reasoning tasks (Claude) and fast responses (Gemini)
|
|
|
+## Models Available
|
|
|
|
|
|
----
|
|
|
+### Antigravity Models (via Google Infrastructure)
|
|
|
|
|
|
-## Installation
|
|
|
+1. **antigravity-gemini-3-pro**
|
|
|
+ - Name: Gemini 3 Pro (Antigravity)
|
|
|
+ - Context: 1M tokens, Output: 65K tokens
|
|
|
+ - Variants: low, high thinking levels
|
|
|
+ - Best for: Complex reasoning, high-quality outputs
|
|
|
|
|
|
-### Prerequisites
|
|
|
+2. **antigravity-gemini-3-flash**
|
|
|
+ - Name: Gemini 3 Flash (Antigravity)
|
|
|
+ - Context: 1M tokens, Output: 65K tokens
|
|
|
+ - Variants: minimal, low, medium, high thinking levels
|
|
|
+ - Best for: Fast responses, efficient agent tasks
|
|
|
|
|
|
-1. **Install oh-my-opencode-slim:**
|
|
|
- ```bash
|
|
|
- bunx oh-my-opencode-slim@latest install
|
|
|
- ```
|
|
|
+3. **antigravity-claude-sonnet-4-5**
|
|
|
+ - Name: Claude Sonnet 4.5 (Antigravity)
|
|
|
+ - Context: 200K tokens, Output: 64K tokens
|
|
|
+ - Best for: Balanced performance
|
|
|
|
|
|
-2. **Set up Antigravity/LLM-Mux:**
|
|
|
- Follow the installation guide at https://nghyane.github.io/llm-mux/#/installation
|
|
|
+4. **antigravity-claude-sonnet-4-5-thinking**
|
|
|
+ - Name: Claude Sonnet 4.5 Thinking (Antigravity)
|
|
|
+ - Context: 200K tokens, Output: 64K tokens
|
|
|
+ - Variants: low (8K budget), max (32K budget)
|
|
|
+ - Best for: Deep reasoning tasks
|
|
|
|
|
|
-3. **Start the Antigravity service:**
|
|
|
- Ensure your Antigravity service is running on `http://127.0.0.1:8317`
|
|
|
+5. **antigravity-claude-opus-4-5-thinking**
|
|
|
+ - Name: Claude Opus 4.5 Thinking (Antigravity)
|
|
|
+ - Context: 200K tokens, Output: 64K tokens
|
|
|
+ - Variants: low (8K budget), max (32K budget)
|
|
|
+ - Best for: Most complex reasoning
|
|
|
|
|
|
----
|
|
|
+### Gemini CLI Models (Fallback)
|
|
|
|
|
|
-## Configuration
|
|
|
+6. **gemini-2.5-flash**
|
|
|
+ - Name: Gemini 2.5 Flash (Gemini CLI)
|
|
|
+ - Context: 1M tokens, Output: 65K tokens
|
|
|
+ - Requires: Gemini CLI authentication
|
|
|
|
|
|
-### Step 1: Configure Provider in OpenCode
|
|
|
+7. **gemini-2.5-pro**
|
|
|
+ - Name: Gemini 2.5 Pro (Gemini CLI)
|
|
|
+ - Context: 1M tokens, Output: 65K tokens
|
|
|
+ - Requires: Gemini CLI authentication
|
|
|
|
|
|
-Edit `~/.config/opencode/opencode.json` and add the "google" provider configuration:
|
|
|
+8. **gemini-3-flash-preview**
|
|
|
+ - Name: Gemini 3 Flash Preview (Gemini CLI)
|
|
|
+ - Context: 1M tokens, Output: 65K tokens
|
|
|
+ - Requires: Gemini CLI authentication
|
|
|
|
|
|
-```json
|
|
|
-{
|
|
|
- "provider": {
|
|
|
- "google": {
|
|
|
- "options": {
|
|
|
- "baseURL": "http://127.0.0.1:8317/v1beta",
|
|
|
- "apiKey": "sk-dummy"
|
|
|
- },
|
|
|
- "models": {
|
|
|
- "gemini-3-pro-high": {
|
|
|
- "name": "Gemini 3 Pro High",
|
|
|
- "attachment": true,
|
|
|
- "limit": {
|
|
|
- "context": 1048576,
|
|
|
- "output": 65535
|
|
|
- },
|
|
|
- "modalities": {
|
|
|
- "input": ["text", "image", "pdf"],
|
|
|
- "output": ["text"]
|
|
|
- }
|
|
|
- },
|
|
|
- "gemini-3-flash": {
|
|
|
- "name": "Gemini 3 Flash",
|
|
|
- "attachment": true,
|
|
|
- "limit": {
|
|
|
- "context": 1048576,
|
|
|
- "output": 65536
|
|
|
- },
|
|
|
- "modalities": {
|
|
|
- "input": ["text", "image", "pdf"],
|
|
|
- "output": ["text"]
|
|
|
- }
|
|
|
- },
|
|
|
- "claude-opus-4-5-thinking": {
|
|
|
- "name": "Claude Opus 4.5 Thinking",
|
|
|
- "attachment": true,
|
|
|
- "limit": {
|
|
|
- "context": 200000,
|
|
|
- "output": 32000
|
|
|
- },
|
|
|
- "modalities": {
|
|
|
- "input": ["text", "image", "pdf"],
|
|
|
- "output": ["text"]
|
|
|
- }
|
|
|
- },
|
|
|
- "claude-sonnet-4-5-thinking": {
|
|
|
- "name": "Claude Sonnet 4.5 Thinking",
|
|
|
- "attachment": true,
|
|
|
- "limit": {
|
|
|
- "context": 200000,
|
|
|
- "output": 32000
|
|
|
- },
|
|
|
- "modalities": {
|
|
|
- "input": ["text", "image", "pdf"],
|
|
|
- "output": ["text"]
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
+9. **gemini-3-pro-preview**
|
|
|
+ - Name: Gemini 3 Pro Preview (Gemini CLI)
|
|
|
+ - Context: 1M tokens, Output: 65K tokens
|
|
|
+ - Requires: Gemini CLI authentication
|
|
|
+
|
|
|
+## Agent Configuration
|
|
|
+
|
|
|
+When you install with `--antigravity=yes`, the preset depends on other providers:
|
|
|
+
|
|
|
+### antigravity-mixed-both (Kimi + OpenAI + Antigravity)
|
|
|
+- **Orchestrator**: Kimi k2p5
|
|
|
+- **Oracle**: GPT-5.2-codex
|
|
|
+- **Explorer/Librarian/Designer/Fixer**: Gemini 3 Flash (Antigravity)
|
|
|
+
|
|
|
+### antigravity-mixed-kimi (Kimi + Antigravity)
|
|
|
+- **Orchestrator**: Kimi k2p5
|
|
|
+- **Oracle**: Gemini 3 Pro (Antigravity)
|
|
|
+- **Explorer/Librarian/Designer/Fixer**: Gemini 3 Flash (Antigravity)
|
|
|
|
|
|
-### Step 2: Configure Agent Models
|
|
|
+### antigravity-mixed-openai (OpenAI + Antigravity)
|
|
|
+- **Orchestrator**: Gemini 3 Flash (Antigravity)
|
|
|
+- **Oracle**: GPT-5.2-codex
|
|
|
+- **Explorer/Librarian/Designer/Fixer**: Gemini 3 Flash (Antigravity)
|
|
|
|
|
|
+### antigravity (Pure Antigravity)
|
|
|
+- **Orchestrator**: Gemini 3 Flash (Antigravity)
|
|
|
+- **Oracle**: Gemini 3 Pro (Antigravity)
|
|
|
+- **Explorer/Librarian/Designer/Fixer**: Gemini 3 Flash (Antigravity)
|
|
|
+
|
|
|
+## Manual Configuration
|
|
|
+
|
|
|
+If you prefer to configure manually, edit `~/.config/opencode/oh-my-opencode-slim.json`:
|
|
|
Edit `~/.config/opencode/oh-my-opencode-slim.json` (or `.jsonc`) and add the Antigravity preset:
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
- "preset": "antigravity",
|
|
|
+ "preset": "antigravity-mixed-both",
|
|
|
"presets": {
|
|
|
- "antigravity": {
|
|
|
+ "antigravity-mixed-both": {
|
|
|
"orchestrator": {
|
|
|
- "model": "google/claude-opus-4-5-thinking",
|
|
|
+ "model": "kimi-for-coding/k2p5",
|
|
|
"skills": ["*"],
|
|
|
"mcps": ["websearch"]
|
|
|
},
|
|
|
"oracle": {
|
|
|
- "model": "google/gemini-3-pro-high",
|
|
|
+ "model": "openai/gpt-5.2-codex",
|
|
|
"variant": "high",
|
|
|
"skills": [],
|
|
|
"mcps": []
|
|
|
},
|
|
|
- "librarian": {
|
|
|
- "model": "google/gemini-3-flash",
|
|
|
+ "explorer": {
|
|
|
+ "model": "google/antigravity-gemini-3-flash",
|
|
|
"variant": "low",
|
|
|
"skills": [],
|
|
|
- "mcps": ["websearch", "context7", "grep_app"]
|
|
|
+ "mcps": []
|
|
|
},
|
|
|
- "explorer": {
|
|
|
- "model": "google/gemini-3-flash",
|
|
|
+ "librarian": {
|
|
|
+ "model": "google/antigravity-gemini-3-flash",
|
|
|
"variant": "low",
|
|
|
"skills": [],
|
|
|
- "mcps": []
|
|
|
+ "mcps": ["websearch", "context7", "grep_app"]
|
|
|
},
|
|
|
"designer": {
|
|
|
- "model": "google/gemini-3-flash",
|
|
|
+ "model": "google/antigravity-gemini-3-flash",
|
|
|
"variant": "medium",
|
|
|
"skills": ["agent-browser"],
|
|
|
"mcps": []
|
|
|
},
|
|
|
"fixer": {
|
|
|
- "model": "google/gemini-3-flash",
|
|
|
+ "model": "google/antigravity-gemini-3-flash",
|
|
|
"variant": "low",
|
|
|
"skills": [],
|
|
|
"mcps": []
|
|
|
@@ -161,222 +154,51 @@ Edit `~/.config/opencode/oh-my-opencode-slim.json` (or `.jsonc`) and add the Ant
|
|
|
}
|
|
|
```
|
|
|
|
|
|
----
|
|
|
-
|
|
|
-## Provider Setup
|
|
|
-
|
|
|
-### Available Models
|
|
|
-
|
|
|
-| Model | Type | Context Window | Output Limit | Best For |
|
|
|
-|-------|------|----------------|--------------|----------|
|
|
|
-| `claude-opus-4-5-thinking` | Claude | 200K tokens | 32K tokens | Complex reasoning, orchestrator |
|
|
|
-| `claude-sonnet-4-5-thinking` | Claude | 200K tokens | 32K tokens | Balanced reasoning and speed |
|
|
|
-| `gemini-3-pro-high` | Gemini | 1M tokens | 65K tokens | High-quality responses |
|
|
|
-| `gemini-3-flash` | Gemini | 1M tokens | 65K tokens | Fast responses, cost-effective |
|
|
|
-
|
|
|
-### Model Recommendations
|
|
|
-
|
|
|
-**For Orchestrator:** Use `claude-opus-4-5-thinking`
|
|
|
-- Best reasoning capabilities for multi-agent coordination
|
|
|
-- Excellent at planning complex workflows
|
|
|
-- Can handle large context windows
|
|
|
-
|
|
|
-**For Oracle:** Use `gemini-3-pro-high`
|
|
|
-- Strategic thinking and debugging
|
|
|
-- High-quality architectural advice
|
|
|
-
|
|
|
-**For Support Agents:** Use `gemini-3-flash`
|
|
|
-- Fast and cost-effective for routine tasks
|
|
|
-- Good for librarian, explorer, designer, and fixer roles
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Agent Model Assignment
|
|
|
-
|
|
|
-### Basic Configuration
|
|
|
+## Troubleshooting
|
|
|
|
|
|
-The preset assigns models based on their strengths:
|
|
|
+### Authentication Failed
|
|
|
+```bash
|
|
|
+# Ensure Antigravity service is running
|
|
|
+# Check service status
|
|
|
+curl http://127.0.0.1:8317/health
|
|
|
|
|
|
-```json
|
|
|
-{
|
|
|
- "presets": {
|
|
|
- "antigravity": {
|
|
|
- "orchestrator": { "model": "google/claude-opus-4-5-thinking" },
|
|
|
- "oracle": { "model": "google/gemini-3-pro-high", "variant": "high" },
|
|
|
- "librarian": { "model": "google/gemini-3-flash", "variant": "low" },
|
|
|
- "explorer": { "model": "google/gemini-3-flash", "variant": "low" },
|
|
|
- "designer": { "model": "google/gemini-3-flash", "variant": "medium" },
|
|
|
- "fixer": { "model": "google/gemini-3-flash", "variant": "low" }
|
|
|
- }
|
|
|
- }
|
|
|
-}
|
|
|
+# Re-authenticate
|
|
|
+opencode auth login
|
|
|
```
|
|
|
|
|
|
-### Custom Assignments
|
|
|
-
|
|
|
-You can customize which model each agent uses:
|
|
|
-
|
|
|
-**Example: All Claude for reasoning-heavy work:**
|
|
|
-```json
|
|
|
-{
|
|
|
- "presets": {
|
|
|
- "claude-heavy": {
|
|
|
- "orchestrator": { "model": "google/claude-opus-4-5-thinking" },
|
|
|
- "oracle": { "model": "google/claude-sonnet-4-5-thinking", "variant": "high" },
|
|
|
- "librarian": { "model": "google/claude-sonnet-4-5-thinking", "variant": "low" },
|
|
|
- "explorer": { "model": "google/claude-sonnet-4-5-thinking", "variant": "low" },
|
|
|
- "designer": { "model": "google/claude-sonnet-4-5-thinking", "variant": "medium" },
|
|
|
- "fixer": { "model": "google/claude-sonnet-4-5-thinking", "variant": "low" }
|
|
|
- }
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
+### Models Not Available
|
|
|
+```bash
|
|
|
+# Verify plugin is installed
|
|
|
+cat ~/.config/opencode/opencode.json | grep antigravity
|
|
|
|
|
|
-**Example: Mixed setup with cost optimization:**
|
|
|
-```json
|
|
|
-{
|
|
|
- "presets": {
|
|
|
- "cost-optimized": {
|
|
|
- "orchestrator": { "model": "google/claude-sonnet-4-5-thinking" },
|
|
|
- "oracle": { "model": "google/gemini-3-pro-high", "variant": "high" },
|
|
|
- "librarian": { "model": "google/gemini-3-flash", "variant": "low" },
|
|
|
- "explorer": { "model": "google/gemini-3-flash", "variant": "low" },
|
|
|
- "designer": { "model": "google/gemini-3-flash", "variant": "low" },
|
|
|
- "fixer": { "model": "google/gemini-3-flash", "variant": "low" }
|
|
|
- }
|
|
|
- }
|
|
|
-}
|
|
|
+# Reinstall plugin
|
|
|
+bunx oh-my-opencode-slim install --antigravity=yes --no-tui --kimi=no --openai=no --tmux=no --skills=no
|
|
|
```
|
|
|
|
|
|
----
|
|
|
-
|
|
|
-## Usage Examples
|
|
|
-
|
|
|
-### Switching to Antigravity Preset
|
|
|
-
|
|
|
+### Wrong Model Selected
|
|
|
```bash
|
|
|
-# Edit the preset in your config
|
|
|
+# Check current preset
|
|
|
+echo $OH_MY_OPENCODE_SLIM_PRESET
|
|
|
+
|
|
|
+# Change preset
|
|
|
export OH_MY_OPENCODE_SLIM_PRESET=antigravity
|
|
|
opencode
|
|
|
```
|
|
|
|
|
|
-### Testing Configuration
|
|
|
-
|
|
|
-1. **Verify provider connection:**
|
|
|
- ```bash
|
|
|
- opencode auth status
|
|
|
- ```
|
|
|
-
|
|
|
-2. **Test agent responses:**
|
|
|
- ```bash
|
|
|
- opencode
|
|
|
- # In OpenCode, run: ping all agents
|
|
|
- ```
|
|
|
-
|
|
|
-3. **Check logs for any connection issues:**
|
|
|
- ```bash
|
|
|
- tail -f ~/.config/opencode/logs/opencode.log
|
|
|
- ```
|
|
|
-
|
|
|
-### Example Workflow
|
|
|
-
|
|
|
-Once configured, you can ask the orchestrator to handle complex tasks:
|
|
|
-
|
|
|
-```
|
|
|
-Orchestrator, please analyze this codebase and create a comprehensive refactoring plan.
|
|
|
-Use your team to:
|
|
|
-1. Map the current architecture
|
|
|
-2. Identify bottlenecks and issues
|
|
|
-3. Create a detailed implementation plan
|
|
|
-4. Estimate effort and risks
|
|
|
-```
|
|
|
-
|
|
|
-The orchestrator will delegate to specialists using the configured Antigravity models.
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## Troubleshooting
|
|
|
-
|
|
|
-### Provider Connection Issues
|
|
|
-
|
|
|
-**Problem:** Agents not responding or showing connection errors
|
|
|
-
|
|
|
-**Solutions:**
|
|
|
-1. Verify Antigravity service is running:
|
|
|
- ```bash
|
|
|
- curl http://127.0.0.1:8317/v1beta/models
|
|
|
- ```
|
|
|
-
|
|
|
-2. Check the baseURL in your config matches your service:
|
|
|
- ```json
|
|
|
- {
|
|
|
- "options": {
|
|
|
- "baseURL": "http://127.0.0.1:8317/v1beta"
|
|
|
- }
|
|
|
- }
|
|
|
- ```
|
|
|
-
|
|
|
-3. Verify your API key (can be dummy value like "sk-dummy")
|
|
|
-
|
|
|
-### Model Not Found Errors
|
|
|
-
|
|
|
-**Problem:** "Model not found" or similar errors
|
|
|
-
|
|
|
-**Solutions:**
|
|
|
-1. Ensure the model names match exactly:
|
|
|
- - `claude-opus-4-5-thinking` (not `claude-opus-4.5-thinking`)
|
|
|
- - `gemini-3-flash` (not `gemini-3-flash-preview`)
|
|
|
-
|
|
|
-2. Check your provider configuration includes all required fields:
|
|
|
- ```json
|
|
|
- {
|
|
|
- "models": {
|
|
|
- "model-name": {
|
|
|
- "name": "Display Name",
|
|
|
- "attachment": true,
|
|
|
- "limit": { "context": 1048576, "output": 65535 },
|
|
|
- "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
- ```
|
|
|
-
|
|
|
-### Authentication Issues
|
|
|
-
|
|
|
-**Problem:** 401 Unauthorized or similar auth errors
|
|
|
-
|
|
|
-**Solutions:**
|
|
|
-1. The `apiKey` can be any dummy value for Antigravity
|
|
|
-2. Ensure the baseURL is correct and accessible
|
|
|
-3. Restart OpenCode after changing configuration
|
|
|
-
|
|
|
-### Performance Issues
|
|
|
-
|
|
|
-**Problem:** Slow responses or timeouts
|
|
|
-
|
|
|
-**Solutions:**
|
|
|
-1. Use `gemini-3-flash` for faster responses on support agents
|
|
|
-2. Check your Antigravity service performance
|
|
|
-3. Consider reducing context sizes for large files
|
|
|
-
|
|
|
-### Switching Between Presets
|
|
|
-
|
|
|
-To test different configurations:
|
|
|
-
|
|
|
+### Service Connection Issues
|
|
|
```bash
|
|
|
-# Use environment variable for quick testing
|
|
|
-export OH_MY_OPENCODE_SLIM_PRESET=openai
|
|
|
-opencode
|
|
|
+# Check if Antigravity service is running on correct port
|
|
|
+lsof -i :8317
|
|
|
|
|
|
+# Restart the service
|
|
|
+# (Follow your Antigravity/LLM-Mux restart procedure)
|
|
|
# Or edit ~/.config/opencode/oh-my-opencode-slim.json (or .jsonc)
|
|
|
# Change the "preset" field and restart OpenCode
|
|
|
```
|
|
|
|
|
|
----
|
|
|
-
|
|
|
-## Additional Resources
|
|
|
+## Notes
|
|
|
|
|
|
-- **LLM-Mux Installation:** https://nghyane.github.io/llm-mux/#/installation
|
|
|
-- **OpenCode Documentation:** https://opencode.ai/docs
|
|
|
-- **Quick Reference:** [docs/quick-reference.md](quick-reference.md)
|
|
|
-- **Installation Guide:** [docs/installation.md](installation.md)
|
|
|
+- **Terms of Service**: Using Antigravity may violate Google's ToS. Use at your own risk.
|
|
|
+- **Performance**: Antigravity models typically have lower latency than direct API calls
|
|
|
+- **Fallback**: Gemini CLI models require separate authentication but work as fallback
|
|
|
+- **Customization**: You can mix and match any models across agents by editing the config
|
Gabriel Rodrigues