Install
$ agentstack add mcp-ccycv-codex-account-rotator ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Codex Account Rotator
Codex Account Rotator is a local Codex plugin and CLI for explicitly switching between named Codex/OpenAI auth profiles that you own or are authorized to use.
It treats auth.json as opaque credential material: it copies the file, stores private backups, and never prints or edits token contents.
Install
Add this repository as a Codex marketplace and install the plugin:
codex plugin marketplace add ccycv/codex-account-rotator --ref main
codex plugin add codex-account-rotator@codex-account-rotator
Start a new Codex thread after installing so the plugin skill and MCP tools are loaded.
CLI Usage
Clone the repo and run the script directly:
git clone https://github.com/ccycv/codex-account-rotator.git
cd codex-account-rotator
node plugins/codex-account-rotator/scripts/codex-account-rotator.js doctor
Common commands:
node plugins/codex-account-rotator/scripts/codex-account-rotator.js save pro1
node plugins/codex-account-rotator/scripts/codex-account-rotator.js save pro2
node plugins/codex-account-rotator/scripts/codex-account-rotator.js list
node plugins/codex-account-rotator/scripts/codex-account-rotator.js switch pro1
node plugins/codex-account-rotator/scripts/codex-account-rotator.js next
To add a shorter command:
mkdir -p ~/.local/bin
ln -sf "$PWD/plugins/codex-account-rotator/scripts/codex-account-rotator.js" ~/.local/bin/codex-account
Workflow
- Log into Codex with one account.
- Save the current auth as a named profile:
codex-account save pro1
- Log into Codex with the next account.
- Save that auth as another profile:
codex-account save pro2
- Switch explicitly when needed:
codex-account switch pro1
codex-account next
Restart Codex after switching so every process reloads the active auth file.
Storage
Default paths:
- Active auth:
~/.codex/auth.json - Saved profiles:
~/.codex-account-profiles/profiles//auth.json - Backups:
~/.codex-account-profiles/backups/ - State:
~/.codex-account-profiles/state.json
Override paths with:
CODEX_HOMECODEX_ACCOUNT_PROFILES--codex-home--profiles-dir
Safety Boundary
This project is for explicit switching between accounts you own or are authorized to use. It does not automate login, account creation, credential extraction, or unattended background cycling.
Development
Run the smoke test:
./tests/smoke.sh
Validate the plugin manifest with the Codex plugin validator if you have it available.
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: ccycv
- Source: ccycv/codex-account-rotator
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.