Skip to content
This repository was archived by the owner on Mar 30, 2026. It is now read-only.

CONFIGURATION.md

Latest commit

 

History

History
245 lines (174 loc) · 7.86 KB

CONFIGURATION.md

File metadata and controls

245 lines (174 loc) · 7.86 KB

Configuration

Create ~/.config/opencode/antigravity.json (or .opencode/antigravity.json in project root):

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
}

Most settings have sensible defaults. Only configure what you need.

Quick Start

Minimal config (recommended for most users):

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
}

With web search enabled:

The plugin provides a google_search tool that the model can call to search the web. No configuration is needed - the tool is always available.

Model Behavior

Settings that affect how the model thinks and responds.

Option Default Description
keep_thinking false Preserve Claude's thinking blocks across turns. Warning: enabling may degrade model stability.
session_recovery true Auto-recover from tool_result_missing errors
auto_resume false Auto-send resume prompt after recovery
resume_text "continue" Text to send when auto-resuming

Note: The web_search config options are deprecated. Google Search is now implemented as a dedicated google_search tool that the model can call explicitly.

About keep_thinking

When true, Claude's thinking blocks are preserved in conversation history:

  • Pros: Model remembers its reasoning, more coherent across turns
  • Cons: May degrade model stability, slightly larger context

When false (default), thinking is stripped:

  • Pros: More stable model behavior, smaller context
  • Cons: Model may be less coherent, forgets previous reasoning

Account Rotation

Settings for managing multiple Google accounts.

Option Default Description
account_selection_strategy "hybrid" How to select accounts
switch_on_first_rate_limit true Switch account immediately on first 429
pid_offset_enabled false Distribute sessions across accounts (for parallel agents)
quota_fallback false Deprecated (ignored). Kept for backward compatibility; Gemini fallback is automatic

Strategy Guide

Your Setup Recommended Strategy Why
1 account "sticky" No rotation needed, preserve prompt cache
2-3 accounts "hybrid" (default) Smart rotation with health scoring
4+ accounts "round-robin" Maximum throughput
Parallel agents "round-robin" + pid_offset_enabled: true Distribute across accounts

Available Strategies

Strategy Behavior Best For
sticky Same account until rate-limited Single account, prompt cache
round-robin Rotate on every request Maximum throughput
hybrid Health score + token bucket + LRU Smart distribution (default)

App Behavior

Settings for plugin behavior.

Option Default Description
quiet_mode false Hide toast notifications (except recovery)
debug false Enable debug logging
log_dir OS default Custom directory for debug logs
auto_update true Enable automatic plugin updates

Debug Logging

{
  "debug": true,
  "debug_tui": true
}

Logs are written to ~/.config/opencode/antigravity-logs/ (or log_dir if set).

Recommended Configs

Copy-paste ready configs with all recommended settings enabled.

1 Account

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "sticky"
}

Why these settings:

  • sticky — No rotation needed, preserves Anthropic prompt cache

2-3 Accounts

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "hybrid"
}

Why these settings:

  • hybrid — Smart rotation using health scores, avoids bad accounts

3+ Accounts (Power Users / Parallel Agents)

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "round-robin",
  "switch_on_first_rate_limit": true,
  "pid_offset_enabled": true
}

Why these settings:

  • round-robin — Maximum throughput, rotates every request
  • switch_on_first_rate_limit — Immediately switch on 429 (default: true)
  • pid_offset_enabled — Different sessions use different starting accounts

What's Enabled by Default

These settings are already true by default — you don't need to set them:

Setting Default What it does
session_recovery true Auto-recover from errors
auto_update true Keep plugin updated
switch_on_first_rate_limit true Fast account switching

These settings are false by default:

Setting Default What it does
keep_thinking false Preserve Claude thinking (may degrade stability)
auto_resume false Auto-continue after recovery

Advanced Settings

These settings are for edge cases. Most users don't need to change them.

Error Recovery (internal)
Option Default Description
empty_response_max_attempts 4 Retries for empty API responses
empty_response_retry_delay_ms 2000 Delay between retries
tool_id_recovery true Fix mismatched tool IDs from context compaction
claude_tool_hardening true Prevent tool parameter hallucination
max_rate_limit_wait_seconds 300 Max wait time when rate limited (0=unlimited)
Token Management (internal)
Option Default Description
proactive_token_refresh true Refresh tokens before expiry
proactive_refresh_buffer_seconds 1800 Refresh 30 min before expiry
proactive_refresh_check_interval_seconds 300 Check interval
Signature Cache (internal)

Used when keep_thinking: true. Most users don't need to configure this.

Option Default Description
signature_cache.enabled true Enable disk caching
signature_cache.memory_ttl_seconds 3600 In-memory cache TTL (1 hour)
signature_cache.disk_ttl_seconds 172800 Disk cache TTL (48 hours)
signature_cache.write_interval_seconds 60 Background write interval
Health Score Tuning (internal)

Used by hybrid strategy. Most users don't need to configure this.

Option Default Description
health_score.initial 70 Starting health score
health_score.success_reward 1 Points added on success
health_score.rate_limit_penalty -10 Points removed on rate limit
health_score.failure_penalty -20 Points removed on failure
health_score.recovery_rate_per_hour 2 Points recovered per hour
health_score.min_usable 50 Minimum score to use account
health_score.max_score 100 Maximum health score
Token Bucket Tuning (internal)

Used by hybrid strategy. Most users don't need to configure this.

Option Default Description
token_bucket.max_tokens 50 Maximum tokens in bucket
token_bucket.regeneration_rate_per_minute 6 Tokens regenerated per minute
token_bucket.initial_tokens 50 Starting tokens