Skip to documentation

Configuration

Providers and models

Authenticate providers locally and select models from live catalogs.

Authenticate on the runner

Provider credentials are read when the runner starts. Restart it after changing authentication. API keys take precedence when both an API key and OAuth handoff are present.

codex login
# Or: export OPENAI_API_KEY=...

claude setup-token
export CLAUDE_CODE_OAUTH_TOKEN=...
# Or: export ANTHROPIC_API_KEY=...

export OPENROUTER_API_KEY=...

Live model catalogs

The runner refreshes authenticated provider catalogs at startup and every 15 minutes. It retains the last successful result after transient failures and treats it as stale after 24 hours.

orchestrator providers status
orchestrator providers refresh
orchestrator providers refresh openai
orchestrator providers refresh anthropic
orchestrator providers refresh openrouter

Pin exact job settings

Each agent selects a provider, catalog-reported model, and supported thinking level. Those exact values travel with the job and are never silently substituted.

Frequently asked questions

Does Codex OAuth use my ChatGPT subscription?

The runner can reuse the existing Codex terminal OAuth session. An OpenAI API key instead uses OpenAI Platform per-token billing.

Can Anthropic use a Claude subscription?

Yes. Run claude setup-token and export its handoff value as CLAUDE_CODE_OAUTH_TOKEN.

Does OpenRouter support OAuth here?

No. The current OpenRouter integration uses an API key.

Why is a model missing from the website?

Confirm local authentication, refresh that provider, and check provider status. Only authenticated catalog models and their supported thinking levels are synchronized.

Do provider credentials reach the hosted website?

No. Provider API keys and OAuth roots remain in the local runner environment. The hosted control plane receives sanitized availability, model catalog metadata, job events, and outcome evidence.

Can agents in one repository use different models?

Yes. Each built-in or custom agent selects its own provider, catalog model, supported thinking level, and repository tool image.