ConcertoNotes oc-codex-setup
Use this skill when the user wants to install, reinstall, upgrade, or troubleshoot oc-codex-multi-auth in OpenCode.
Default install
npx -y oc-codex-multi-auth@latest
Use this when the user wants the full catalog config, including base entries like gpt-5.5 and explicit preset entries like gpt-5.5-medium.
Modern compact install
npx -y oc-codex-multi-auth@latest --modern
Use this on OpenCode v1.0.210+ when the user wants the compact variant-based config.
Login and verification
- Run
opencode auth login. - Run a quick verification request:
opencode run "Explain this repository" --model=openai/gpt-5.5-medium
- For a Codex-focused workflow, try:
opencode run "Refactor the retry logic and update the tests" --model=openai/gpt-5-codex --variant=high
Troubleshooting
- Confirm
"plugin": ["oc-codex-multi-auth"]is present in the OpenCode config. - Re-run
opencode auth loginif tokens expired or the wrong workspace was selected. - Inspect
~/.opencode/logs/codex-plugin/after a failed request. - Set
ENABLE_PLUGIN_REQUEST_LOGGING=1for deeper request logging. - For full docs, see
docs/getting-started.md,docs/configuration.md,docs/troubleshooting.md, anddocs/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.