npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

oc-codex-multi-auth

v6.2.0

Published

OpenCode plugin for ChatGPT Plus/Pro OAuth with Codex/GPT-5 routing, multi-account rotation, account switching, health checks, diagnostics, and recovery tools

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

ndycodendycode

Keywords

opencodeopencode-pluginopencode-authopenaichatgptchatgpt-pluschatgpt-prooauthoauth2oauth-loginpkcecodexcodex-authcodex-oauthgpt-5gpt-5-5multi-accountaccount-rotationaccount-switchingaccount-healthhealth-checksquota-managementdiagnosticsrecovery-toolsterminal-uideveloper-toolstypescriptnodejs

Readme

oc-codex-multi-auth: ChatGPT OAuth and multi-account Codex routing for OpenCode

npm version npm downloads CI MIT license

oc-codex-multi-auth is an OpenCode plugin for ChatGPT Plus/Pro OAuth, Codex and GPT-5 model routing, multi-account rotation, account switching, health checks, quota visibility, diagnostics, and recovery tools. It installs the OpenCode provider/TUI configuration, registers a codex-* command toolkit, and routes OpenCode OpenAI SDK requests through the ChatGPT-backed Codex flow with local account state.

Use it when you want OpenCode to run Codex-style coding workflows from your own ChatGPT subscription while keeping accounts visible, switchable, health-checked, and recoverable from the terminal.

[!NOTE] This package is the supported OpenCode plugin line. Older package names and config entries should be replaced with oc-codex-multi-auth.

What You Get

  • OpenCode plugin support for ChatGPT Plus/Pro OAuth and Codex/GPT-5 coding workflows
  • Ready-to-use GPT-5.5, GPT-5.5 Fast, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5.1, and Codex model templates
  • Compact modern OpenCode config with variant-based selectors, plus explicit legacy selector IDs when needed
  • Stateless Codex-compatible request handling with store: false and reasoning.encrypted_content
  • Multi-account rotation with health-aware selection, cooldowns, automatic token refresh, and failover
  • Explicit saved-account listing, account switching, labeling, tagging, notes, health checks, and diagnostics
  • Per-project account storage under ~/.opencode/projects/<project-key>/...
  • Guided setup, doctor, next-action, dashboard, export/import, keychain, and troubleshooting tools
  • Optional OS-native keychain backend for stored account pools
  • TUI prompt quota status and quota detail views for OpenCode sessions
  • Request logging, runtime metrics, routing visibility, and redacted diagnostic snapshots for debugging
  • Stable docs for install, configuration, troubleshooting, privacy, architecture, testing, and release history

Why Developers Use It

oc-codex-multi-auth makes OpenCode's ChatGPT OAuth state understandable and operable. Instead of treating auth as one opaque provider file, you get a local account pool, deterministic account switching, health-aware request selection, visible quota status, JSON-friendly diagnostics, and safe repair commands for stale or damaged state. The plugin is designed for personal development workflows: credentials stay local, OpenCode keeps owning the host runtime, and the plugin only handles the OAuth-backed Codex routing layer it is installed for.

Current Architecture At A Glance

oc-codex-multi-auth ships four user-visible surfaces:

| Surface | Purpose | | --- | --- | | oc-codex-multi-auth | npm installer bin; updates ~/.config/opencode/opencode.json, manages tui.json, normalizes stale plugin entries, and clears OpenCode plugin cache | | OpenCode plugin entry (index.ts) | auth loader, OAuth login modes, provider fetch pipeline, account rotation, retry/failover, and codex-* tool registry | | OpenCode TUI plugin (tui.ts) | prompt quota status, quota details, shared quota cache, and active-account-aware display | | 21 codex-* tools | setup, help, status, list, switch, limits, health, metrics, doctor, dashboard, backup, keychain, diagnostics, and recovery actions |

The plugin does not replace OpenCode. OpenCode remains the host; this package installs provider/TUI config and supplies the OAuth-backed Codex request pipeline that OpenCode calls.

[!CAUTION] This project is for personal development use with your own ChatGPT Plus/Pro subscription.

By using this plugin, you acknowledge:

  • This is an independent open-source project, not an official OpenAI product
  • It is not intended for commercial resale, shared multi-user access, or production services
  • You are responsible for your own usage and policy compliance
  • For production/commercial workloads, use the OpenAI Platform API

Installation

Option A: Standard install

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

Option B: Full explicit model catalog

Use this when you want direct selector IDs such as openai/gpt-5.5-medium in addition to OpenCode variants.

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

Option C: Verify wiring

opencode --version
opencode debug config
opencode auth login

The installer updates ~/.config/opencode/opencode.json, backs up the previous config, normalizes the plugin entry to "oc-codex-multi-auth", enables the TUI status plugin in ~/.config/opencode/tui.json, and clears the OpenCode cached plugin copy so OpenCode reinstalls the latest package.

Step-by-step

  1. Install or refresh config:
    • npx -y oc-codex-multi-auth@latest
  2. Run first login flow:
    • opencode auth login
  3. Validate config:
    • opencode debug config
  4. Run a smoke request:
    • opencode run "Explain this repository" --model=openai/gpt-5.5 --variant=medium
  5. Inspect plugin state with the OpenCode tool surface:
    • codex-status
    • codex-doctor
    • codex-list

Verification

opencode debug config
opencode auth login
opencode run "ping" --model=openai/gpt-5.5 --variant=medium

Quick Start

Install and sign in:

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

Run a prompt with compact modern selectors:

opencode run "Summarize the failing test and suggest a fix" --model=openai/gpt-5.5 --variant=medium
opencode run "Summarize the failing test and suggest a fix" --model=openai/gpt-5.5-fast --variant=medium

Use Codex-focused routing:

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

If browser launch is blocked, use the alternate login paths in docs/getting-started.md.

Command Toolkit

Start here

| Tool | What it answers | | --- | --- | | codex-setup | How do I finish first-run setup safely? | | codex-help | Which plugin commands exist and what do they do? | | codex-doctor | What is wrong with auth, config, storage, or routing? | | codex-next | What should I do next to get unstuck? |

Daily use

| Tool | What it answers | | --- | --- | | codex-list | Which accounts are saved and which one is active? | | codex-switch | How do I move to a different saved account? | | codex-status | Which account, model family, and routing state are active? | | codex-limits | What quota or rate-limit state is visible now? | | codex-dashboard | Can I manage accounts from one interactive surface? |

Account management

| Tool | What it answers | | --- | --- | | codex-label | How do I name an account? | | codex-tag | How do I group accounts with tags? | | codex-note | How do I attach a private note to an account? | | codex-remove | How do I remove a saved account safely? | | codex-refresh | How do I refresh or re-login an account? |

Diagnostics and backup

| Tool | What it answers | | --- | --- | | codex-health | Which accounts look healthy, limited, or disabled? | | codex-metrics | What runtime counters and request metrics are visible? | | codex-diag | Can I export a redacted diagnostic snapshot? | | codex-diff | What changed between account/config snapshots? | | codex-export | How do I back up account storage? | | codex-import | How do I restore accounts with a dry-run first? | | codex-keychain | Which credential backend is active and can I migrate it? |

Reliability behavior

  • stateless request handling forces store: false
  • reasoning.encrypted_content is preserved for multi-turn continuity
  • account rotation is health-aware and avoids repeatedly selecting cooling accounts
  • 5xx bursts, network failures, and quota responses penalize account health
  • token refresh is queued to avoid refresh races
  • unsupported-model handling is strict by default, with opt-in fallback controls
  • TUI quota status follows the account/workspace used by the latest request

Storage Paths

| File | Default path | | --- | --- | | OpenCode config | ~/.config/opencode/opencode.json | | OpenCode TUI config | ~/.config/opencode/tui.json | | OpenCode auth tokens | ~/.opencode/auth/openai.json | | Plugin config | ~/.opencode/openai-codex-auth-config.json | | Global account storage | ~/.opencode/oc-codex-multi-auth-accounts.json | | Per-project accounts | ~/.opencode/projects/<project-key>/oc-codex-multi-auth-accounts.json | | Flagged accounts | ~/.opencode/oc-codex-multi-auth-flagged-accounts.json | | Backups | ~/.opencode/backups/ or ~/.opencode/projects/<project-key>/backups/ | | Logs | ~/.opencode/logs/codex-plugin/ | | TUI quota cache | OpenCode state path plus ~/.opencode/oc-codex-multi-auth-tui-quota.json fallback |

Per-project storage is enabled by default. The plugin walks up from the current directory to find a project root, then stores account pools under the project-specific key. If no project root is found, it falls back to global storage.

Configuration

Primary config files:

  • ~/.config/opencode/opencode.json
  • ~/.config/opencode/tui.json
  • ~/.opencode/openai-codex-auth-config.json

Selected runtime/environment overrides:

| Variable | Effect | | --- | --- | | CODEX_AUTH_REQUEST_TRANSFORM_MODE=legacy | Re-enable legacy Codex request rewriting | | CODEX_MODE=0/1 | Disable/enable bridge prompt behavior | | CODEX_TUI_V2=0/1 | Disable/enable codex-style tool output | | CODEX_TUI_COLOR_PROFILE=truecolor|ansi256|ansi16 | Force terminal color profile | | CODEX_TUI_GLYPHS=ascii|unicode|auto | Force terminal glyph style | | CODEX_TUI_MASK_EMAIL=0/1 | Hide account email in TUI quota status only | | CODEX_TUI_MASK_EMAIL_DETAILS=0/1 | Also hide account email in quota details when prompt masking is enabled | | CODEX_AUTH_PER_PROJECT_ACCOUNTS=0/1 | Disable/enable per-project account pools | | CODEX_AUTH_AUTO_UPDATE=0/1 | Disable/enable daily npm update check and cache refresh | | CODEX_AUTH_UNSUPPORTED_MODEL_POLICY=strict|fallback | Control unsupported-model retry behavior | | CODEX_AUTH_ACCOUNT_ID=<id> | Force a specific workspace/account id | | CODEX_AUTH_FETCH_TIMEOUT_MS=<ms> | Request timeout override | | CODEX_AUTH_STREAM_STALL_TIMEOUT_MS=<ms> | SSE stream stall timeout override | | ENABLE_PLUGIN_REQUEST_LOGGING=1 | Enable request metadata logs | | CODEX_PLUGIN_LOG_BODIES=1 | Include raw request/response bodies in logs; sensitive | | CODEX_KEYCHAIN=1 | Opt in to OS-native keychain account storage |

Validate config after changes:

opencode debug config
opencode run "test" --model=openai/gpt-5.5 --variant=medium

Modern OpenCode versions use config/opencode-modern.json. Older versions can use config/opencode-legacy.json. See config/README.md for the full model template matrix.

Credential Storage

By default, account pools are stored locally as V3 JSON files. File permissions are restricted where the platform supports them.

Use JSON storage when you want predictable, inspectable local files and easy backup/export behavior.

Set CODEX_KEYCHAIN=1 to store account pools in the OS keychain instead:

  • macOS: Keychain
  • Windows: Credential Manager
  • Linux: libsecret, with a running secret service such as GNOME Keyring or KWallet

Manage the backend from OpenCode:

codex-keychain status
codex-keychain migrate
codex-keychain rollback

If the keychain is unavailable, the plugin logs a warning and falls back to JSON storage for that operation. Credentials are never silently deleted.

Troubleshooting

codex-doctor --fix
codex-next
codex-status format="json"

If still broken:

opencode auth login
  • Plugin does not load: rerun npx -y oc-codex-multi-auth@latest, then restart OpenCode
  • Config looks wrong: run opencode debug config and confirm "plugin": ["oc-codex-multi-auth"]
  • OAuth callback fails: free port 1455, then rerun opencode auth login
  • Browser launch is blocked: use the remote/headless login path from docs/getting-started.md
  • Wrong account is selected: run codex-list, then codex-switch
  • Account pool looks unhealthy: run codex-health format="json" and codex-doctor deep=true format="json"
  • Import/export feels risky: run codex-import path="..." dryRun=true before applying
  • Debugging model fallback: enable ENABLE_PLUGIN_REQUEST_LOGGING=1 and inspect ~/.opencode/logs/codex-plugin/
codex-status format="json"
codex-limits format="json"
codex-health format="json"
codex-next format="json"
codex-list format="json"
codex-dashboard format="json"
codex-metrics format="json"
codex-doctor deep=true format="json"

Documentation

Release Notes

Merging the release-please PR cuts the tagged release and publishes the package through the configured release workflow. Manual npm publish is not required for routine releases.

License

MIT License. See LICENSE.

  • Not affiliated with OpenAI.
  • "ChatGPT", "GPT-5", "Codex", and "OpenAI" are trademarks of OpenAI.
  • You assume responsibility for your own usage and compliance.