Skip to content

README.md

Latest commit

 

History

History
103 lines (72 loc) · 5.11 KB

README.md

File metadata and controls

103 lines (72 loc) · 5.11 KB

Configuration

This directory contains the official OpenCode config templates for oc-codex-multi-auth.

Required: choose the right config file

File OpenCode version Description
opencode-modern.json v1.0.210+ Variant-based config: 9 base models with 36 total presets
opencode-legacy.json v1.0.209 and below Legacy explicit entries: 36 individual model definitions

The installer uses the compact modern template by default so the model picker shows only base OAuth model families. Rerun the default installer to remove explicit preset IDs and stale base models left by earlier plugin catalogs. Use --full when you want the explicit preset IDs installed too.

Quick pick

If your OpenCode version is v1.0.210 or newer:

cp config/opencode-modern.json ~/.config/opencode/opencode.json

If your OpenCode version is v1.0.209 or older:

cp config/opencode-legacy.json ~/.config/opencode/opencode.json

Check your version with:

opencode --version

Why there are two templates

OpenCode v1.0.210+ added model variants, so one model entry can expose multiple reasoning levels. That keeps modern config much smaller while preserving the same effective presets.

Both templates include:

  • GPT-5.5, GPT-5.5 Fast, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5 Codex, GPT-5.1, GPT-5.1 Codex, GPT-5.1 Codex Max, GPT-5.1 Codex Mini
  • Reasoning variants per model family
  • store: false and include: ["reasoning.encrypted_content"]
  • Context metadata (gpt-5.5/gpt-5.5-fast: 1,050,000; gpt-5.4-mini/gpt-5.4-nano/Codex models: 400,000; gpt-5.1: 272,000; all output: 128,000)

Use opencode debug config to verify that these template entries were merged into your effective config. The default compact install shows base OAuth entries such as gpt-5.5 / gpt-5.5-fast; the separate OpenCode variant picker exposes the reasoning presets.

If your OpenCode runtime supports global compaction tuning, you can also set:

  • model_context_window = 1050000
  • model_auto_compact_token_limit = 950000

Spark model note

The templates intentionally do not include gpt-5.3-codex-spark by default. Spark is often entitlement-gated at the account/workspace level, so shipping it by default causes avoidable startup failures for many users.

If your workspace is entitled, you can add Spark model IDs manually.

Usage examples

Recommended compact UI selectors:

opencode run "task" --model=openai/gpt-5.5 --variant=medium
opencode run "task" --model=openai/gpt-5.5-fast --variant=medium
opencode run "task" --model=openai/gpt-5-codex --variant=high

If you need direct explicit selector IDs for scripts, install with:

npx -y oc-codex-multi-auth@latest --full

Minimal config (advanced)

A barebones debug template is available at minimal-opencode.json. It omits the full preset catalog.

Unsupported-model behavior

Current defaults are strict entitlement handling except for default public selectors that are commonly entitlement-gated:

  • gpt-5.5 and canonical gpt-5-codex can auto-fallback through gpt-5.4, gpt-5.4-mini, then gpt-5.4-nano when the backend reports the selected model is not supported for the active account/workspace
  • unsupportedCodexPolicy: "strict" returns other entitlement errors directly
  • set unsupportedCodexPolicy: "fallback" (or CODEX_AUTH_UNSUPPORTED_MODEL_POLICY=fallback) to enable the full fallback chain for manual/legacy selectors
  • fallbackToGpt52OnUnsupportedGpt53: true keeps the legacy gpt-5.3-codex -> gpt-5.2-codex edge inside fallback mode
  • user-typed gpt-5.5-pro* is canonicalized to gpt-5.5 before fallback because GPT-5.5 Pro is ChatGPT-only, not a Codex-routable model
  • legacy Codex selectors such as gpt-5.2-codex, gpt-5.3-codex, and gpt-5.3-codex-spark normalize to canonical gpt-5-codex; if that canonical Codex model is gated, the default auto-fallback can retry through the GPT-5.4 family
  • set CODEX_AUTH_DISABLE_GPT55_AUTO_FALLBACK=1 to disable GPT-5.5 auto-fallback
  • set CODEX_AUTH_DISABLE_CODEX_AUTO_FALLBACK=1 to disable canonical Codex/GPT-5.4-family auto-fallback
  • gpt-5.4-pro -> gpt-5.4 remains available for older manual configs
  • unsupportedCodexFallbackChain lets you override fallback order per model

Default fallback chain (auto-fallback for gpt-5.5/gpt-5-codex through the GPT-5.4 family; full chain when policy is fallback):

  • gpt-5.5 -> gpt-5.4 -> gpt-5.4-mini -> gpt-5.4-nano
  • gpt-5-codex -> gpt-5.4 -> gpt-5.4-mini -> gpt-5.4-nano
  • gpt-5.4-pro -> gpt-5.4 (if you manually select gpt-5.4-pro)
  • gpt-5.3-codex -> gpt-5-codex -> gpt-5.2-codex
  • gpt-5.3-codex-spark -> gpt-5-codex -> gpt-5.3-codex -> gpt-5.2-codex (only relevant if Spark IDs are added manually)
  • gpt-5.2-codex -> gpt-5-codex
  • gpt-5.1-codex -> gpt-5-codex

Additional docs