Files
opencode/docs/PROVIDERS.md
T
Artur Do Lago a02bfd2c10 fix(config): consolidate providers and agent definitions
- Disable google-vertex and google-vertex-anthropic (redundant with Antigravity)
- Remove non-working antigravity provider config
- Use built-in antigravity-* models from provider.ts
- Add zee, stanley, johny agent definitions
- Update compaction to use google/antigravity-gemini-3-flash
- Update johny.md to use google/antigravity-claude-opus-4-5-thinking
- Remove top_p from agent files (handled by ProviderTransform)
- Add docs/PROVIDERS.md with provider setup documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 12:30:39 +01:00

3.1 KiB

Provider Configuration

This document describes the working provider setup for agent-core.

Config Locations

Type Location
Project config ~/.local/src/agent-core/.agent-core/agent-core.jsonc
Global config (symlink) ~/.config/agent-core/agent-core.jsonc
Agent definitions ~/.local/src/agent-core/.agent-core/agent/
Global agents (symlink) ~/.config/agent-core/agent/

The global config is symlinked to project config so changes in one location reflect in both.

Providers

Google (Antigravity)

Free-tier models via the opencode-antigravity-auth plugin.

Provider ID: google

Available Models:

Model ID Display Name Type
google/antigravity-claude-opus-4-5-thinking Claude Opus 4.5 Thinking Reasoning
google/antigravity-claude-sonnet-4-5 Claude Sonnet 4.5 Standard
google/antigravity-claude-sonnet-4-5-thinking Claude Sonnet 4.5 Thinking Reasoning
google/antigravity-gemini-3-pro Gemini 3 Pro Reasoning
google/antigravity-gemini-3-flash Gemini 3 Flash Fast

Notes:

  • Models are hardcoded in provider.ts and auto-loaded when the antigravity plugin detects auth
  • Opus 4.5 is only available as the -thinking variant
  • Thinking models require topP >= 0.95 (handled automatically by ProviderTransform)

Cerebras

Provider ID: cerebras

Custom Models (defined in config):

Model ID Display Name
cerebras/zai-glm-4.7 GLM-4.7 (Z.AI on Cerebras)

Environment: CEREBRAS_API_KEY

OpenRouter

Provider ID: openrouter

Environment: OPENROUTER_API_KEY

Access to various models including Grok, Llama, etc.

Disabled Providers

These are disabled in agent-core.jsonc:

  • google-vertex - Direct Vertex AI (redundant with Antigravity)
  • google-vertex-anthropic - Vertex Claude (redundant with Antigravity)

Agent Defaults

Agent Default Model Purpose
Zee cerebras/zai-glm-4.7 Personal assistant
Stanley openrouter/x-ai/grok-4.1-fast Investing assistant
Johny google/antigravity-claude-opus-4-5-thinking Learning assistant
title cerebras/gpt-oss-120b Conversation titles (hidden)
compaction google/antigravity-gemini-3-flash Context compaction (hidden)

Auth Storage

Provider Auth Location Type
Google (Antigravity) ~/.local/share/agent-core/auth.json under google key OAuth
Cerebras Environment variable API Key
OpenRouter Environment variable API Key

Adding New Models

To add custom models to an existing provider, add to the provider section in agent-core.jsonc:

"provider": {
  "provider-id": {
    "models": {
      "model-id": {
        "name": "Display Name",
        "temperature": true,
        "reasoning": false,
        "tool_call": true,
        "attachment": true,
        "limit": { "context": 200000, "output": 8192 },
        "cost": { "input": 0, "output": 0 }
      }
    }
  }
}