version: "1.0.1" name: oc-codex-setup description: Install or refresh oc-codex-multi-auth in OpenCode, choose the right config mode, and verify Codex OAuth with ChatGPT Plus or Pro access.

oc-codex-setup

Use this skill when the user wants to install, reinstall, upgrade, or troubleshoot oc-codex-multi-auth in OpenCode.

Default install (provider preserving)

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

This is the default. It registers the OpenCode and TUI plugin entries without changing provider.openai.

Compact modern catalog

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

Use this when the shipped 12 base OAuth model families and 53 OpenCode variant presets are required.

Config-safe update

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

Use this to refresh an existing installation. It only clears the managed package cache and never reads or writes opencode.json or tui.json. Restart OpenCode afterward.

Plugin-only install

npx -y oc-codex-multi-auth@latest install --plugin-only

Use this when the user already manages provider.openai. It registers the OpenCode and TUI plugin entries without changing that provider configuration.

Full install (explicit selector IDs)

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

Use this when the user needs direct selector IDs such as openai/gpt-5.5-medium or openai/gpt-5.6-sol-high in addition to the compact bases.

Legacy install (older OpenCode)

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

Use this on older OpenCode versions that do not support variant-based model entries. Installs 53 explicit model IDs only.

Other installer flags

• --dry-run — show changed config paths without values or writes
• --no-cache-clear — skip clearing the OpenCode plugin cache
• --modern — install the compact modern catalog
• --plugin-only — preserve provider.openai; cannot be combined with a catalog mode

Standalone CLI (no agent cost)

oc-codex-multi-auth status
oc-codex-multi-auth list
oc-codex-multi-auth warm
oc-codex-multi-auth doctor

Also available: limits, dashboard, health, diag.

Login and verification

1. Run opencode auth login.
2. Run a quick verification request after OpenCode or --modern supplies the selector:

opencode run "Explain this repository" --model=openai/gpt-5.5 --variant=medium

Do not use openai/gpt-5.5-medium unless the user installed with --full or --legacy.

1. Optional GPT-5.6 smoke:

opencode run "Explain this repository" --model=openai/gpt-5.6-sol --variant=medium

1. For a Codex-focused workflow, try:

opencode run "Refactor the retry logic and update the tests" --model=openai/gpt-5-codex --variant=high

1. After --full, explicit IDs are valid:

opencode run "Explain this repository" --model=openai/gpt-5.5-medium

Troubleshooting

• Confirm "plugin": ["oc-codex-multi-auth"] is present in the OpenCode config.
• Re-run opencode auth login if tokens expired or the wrong workspace was selected.
• Inspect ~/.opencode/logs/codex-plugin/ after a failed request.
• Set ENABLE_PLUGIN_REQUEST_LOGGING=1 for deeper request logging.
• For full docs, see docs/getting-started.md, docs/configuration.md, docs/troubleshooting.md, and docs/faq.md.

Usage boundaries

This project is for personal development use with your own ChatGPT Plus or Pro subscription. For production or shared services, prefer the OpenAI Platform API.