OpenCode Antigravity Autopilot


Intelligent quota management and model rotation for opencode-antigravity-auth. Automatically switches models when quota runs low, tracks usage across accounts, and works with both OpenCode and oh-my-opencode.

Quick Install

New to the Antigravity ecosystem? Start here:

👉 Complete Installation Guide - Step-by-step setup for auth + quota + oh-my-opencode

Let an LLM set it up:

``
Set up opencode-antigravity-autopilot for me. Follow:
https://raw.githubusercontent.com/gooseware/opencode-antigravity-autopilot/main/INSTALL.md

Ask me:
1. Am I using oh-my-opencode or vanilla OpenCode?
2. What models do I prefer? (e.g., gemini-3-pro, claude-sonnet-4-5-thinking)
3. Should quota rotation be automatic?

Then configure everything for me.
`

Manual Install

$3

- opencode-antigravity-auth installed and authenticated
- Node.js >= 20

$3

`bash
npm install opencode-antigravity-autopilot
`

Configuration

$3

Add to ~/.config/opencode/opencode.json:

`json
{
"plugin": [
"opencode-antigravity-auth@beta",
"opencode-antigravity-autopilot"
]
}
`

$3

Add to ~/.config/opencode/oh-my-opencode.json:

`json
{
"google_auth": false,
"quota_rotation": true,
"agents": {
"Sisyphus": { "model": "google/antigravity-claude-sonnet-4-5" },
"librarian": { "model": "google/antigravity-gemini-3-flash" },
"explore": { "model": "google/antigravity-gemini-3-flash" },
"oracle": { "model": "google/antigravity-claude-opus-4-5-thinking" }
}
}
`

Usage

$3

`typescript
import { QuotaManager } from 'opencode-antigravity-autopilot';

const manager = new QuotaManager({
quotaThreshold: 0.2,
preferredModels: [
'google/antigravity-gemini-3-pro',
'google/antigravity-claude-sonnet-4-5'
]
});

await manager.initialize();

const bestModel = manager.selectBestModel();
console.log(Using model: ${bestModel});

const quota = await manager.getQuota();
console.log(Remaining quota: ${quota?.remainingFraction * 100}%);
`

$3

`typescript
import { createOhMyOpenCodeIntegration, QuotaManager } from 'opencode-antigravity-autopilot';

const manager = new QuotaManager();
await manager.initialize();

const integration = createOhMyOpenCodeIntegration(manager, {
defaultModel: 'google/antigravity-gemini-3-flash'
});

const modelForAgent = await integration.getModelForAgent('oracle');
console.log(Oracle will use: ${modelForAgent});
`

$3

`typescript
manager.setModelRotationStrategy({
preferredModels: [
'google/antigravity-gemini-3-pro-high',
'google/antigravity-claude-sonnet-4-5-thinking'
],
fallbackModels: [
'google/antigravity-gemini-3-flash',
'google/gemini-2.5-flash'
],
quotaThreshold: 0.15
});
`

Features

- Automatic Model Rotation: Switches to fallback models when quota drops below threshold
- Multi-Account Support: Leverages opencode-antigravity-auth's account pool
- Quota Tracking: Real-time monitoring via LSP process
- oh-my-opencode Compatible: Dynamic agent model assignment
- Zero Config: Works out-of-box with sensible defaults

How It Works

1. Reads authenticated accounts from opencode-antigravity-auth storage
2. Monitors quota via Antigravity LSP process (passive monitoring)
3. Tracks quota per model and selects best available option
4. Auto-rotates accounts when current account is exhausted
5. Integrates with oh-my-opencode for agent-level model management

API

$3

`typescript
const manager = new QuotaManager(config?: PluginConfig);
await manager.initialize();

manager.getQuota(): Promise
manager.selectBestModel(): string | null
manager.rotateAccount(): Promise
manager.updateQuotaForModel(model: string, quota: QuotaInfo): void
manager.setModelRotationStrategy(strategy: ModelRotationStrategy): void
`

$3

`typescript
const integration = createOhMyOpenCodeIntegration(manager, config);

integration.getModelForAgent(agentName: string, preferredModel?: string): Promise
integration.updateAgentConfig(config: OhMyOpenCodeConfig, strategy: ModelRotationStrategy): OhMyOpenCodeConfig
integration.pollQuotaAndRotate(models: string[]): Promise
`

Configuration Options

`typescript
interface PluginConfig {
quotaThreshold?: number; // Default: 0.2 (20%)
pollIntervalMs?: number; // Default: 60000 (1 min)
enableRotation?: boolean; // Default: true
preferredModels?: string[]; // Models to prefer
}
`

Troubleshooting

LSP Process Not Found
- Ensure Antigravity IDE is running
- Check ps aux | grep language_server_antigravity

Quota Always Shows Null
- Verify opencode-antigravity-auth is authenticated
- Restart Antigravity IDE

Models Not Rotating
- Check quotaThreshold` setting
- Verify preferred models are configured correctly

Credits

Built on opencode-antigravity-auth by @NoeFabris. This plugin extends its authentication system with intelligent quota management.

License

MIT

Contributing

Issues and PRs welcome at github.com/gooseware/opencode-antigravity-autopilot