oauth-accounts

name	oauth-accounts
description	Manage multiple ChatGPT OAuth accounts for Codex using Codex Switch. Use this when the user wants a simple way to add accounts, switch accounts, or move to the next account after rate limits.

OAuth Accounts

Use Codex Switch instead of editing auth.json by hand.

Prefer These Commands

First-time setup:

codex-switch wizard

Add the currently logged-in account:

codex-switch add

Open codex login and add that account:

codex-switch login-add

Pick which account Codex should use:

codex-switch use

Switch to the next ready account:

codex-switch next

Mark the current account rate-limited and move on:

codex-switch limit --retry-after 60

Inspect health:

codex-switch doctor
codex-switch list

Rules

• Prefer wizard, add, login-add, use, next, and limit over the lower-level commands.
• Keep OPENAI_API_KEY intact unless the user explicitly asks to clear it.
• Remind the user that this plugin cannot rotate accounts inside an already running Codex core session.
• If cli_auth_credentials_store is set to keyring or auto, tell the user to switch to file auth for this plugin workflow.