codex-account-rotator

name	codex-account-rotator
description	Use when the user asks to save, list, switch, or rotate between multiple Codex/OpenAI login profiles backed by ~/.codex/auth.json. This is for explicit user-owned paid-account switching, not unattended quota evasion.

Codex Account Rotator

Use this skill when managing local Codex account profiles for the current user.

Safety rules

• Treat auth.json as opaque credential material. Never print, parse, summarize, or transform its contents.
• Use explicit profile names and explicit user intent before switching accounts.
• Prefer listing or switching through the MCP tools if installed. If the tools are unavailable, run the local script at scripts/codex-account-rotator.js.
• After any switch, tell the user that restarting Codex is recommended because running processes may keep old auth in memory.
• Do not build unattended background cycling or account-limit bypass behavior. The supported rotation is a user-triggered switch to the next enabled profile.

Typical workflow

1. User logs into Codex with the first account.
2. Save it with codex_account_save_current or:

~/plugins/codex-account-rotator/scripts/codex-account-rotator.js save personal

3. User logs out/in with the next account, then saves it under another profile name.
4. When they need to move to another paid account, switch explicitly:

~/plugins/codex-account-rotator/scripts/codex-account-rotator.js switch work

Or rotate to the next enabled profile:

~/plugins/codex-account-rotator/scripts/codex-account-rotator.js next

Available MCP tools

• codex_account_list: list saved profiles without revealing credentials.
• codex_account_save_current: save the current auth.json under a profile name.
• codex_account_switch: switch to a named profile.
• codex_account_next: switch to the next enabled profile.
• codex_account_set_enabled: include or skip a profile in next.
• codex_account_backup_current: back up the active auth.json.
• codex_account_doctor: show local path and metadata diagnostics.