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 13 base OAuth model families and 59 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, openai/gpt-6-astra-high, 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 59 explicit model IDs only.

When OpenCode already loads a local checkout

Check the existing plugin array before installing. An entry pointing at a clone of this repository means the user is running their own build on purpose.

Every installer mode keeps that entry as written and adds nothing beside it, so running the installer is safe; it registers the published package only when no entry resolves to this plugin. Prefer update anyway when the goal is just to refresh a stale package cache, since it never opens either config file.

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.

3. Optional GPT-6 Astra / GPT-5.6 smoke:

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

4. For a Codex-focused workflow, try:

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

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

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

Troubleshooting

• Confirm the OpenCode config registers the plugin, as "plugin": ["oc-codex-multi-auth"] or as a path to the user's own checkout.
• 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.