@a3fckx/opencode-multi-auth
v1.0.4
Published
Multi-account OAuth rotation for OpenAI Codex with auto model discovery
Maintainers
Readme
opencode-multi-auth
Multi-account OAuth rotation for OpenAI Codex. Auto-rotates between your ChatGPT Plus/Pro accounts.
Based on opencode-openai-codex-auth by @nummanali. Forked and modified to add multi-account rotation support.
Installation
Via npm (Recommended)
Add to your ~/.config/opencode/opencode.json:
{
"plugin": ["@a3fckx/opencode-multi-auth"]
}OpenCode will auto-install on first run.
Manual Install
If auto-install fails, install manually:
bun add @a3fckx/opencode-multi-auth --cwd ~/.config/opencodeFrom Source
git clone https://github.com/a3fckx/opencode-multi-auth.git
cd opencode-multi-auth
bun install
bun run build
bun linkAdd Your Accounts
# Add each account (opens browser for OAuth)
opencode-multi-auth add personal
opencode-multi-auth add work
opencode-multi-auth add backup
# Each command opens your browser - log in with a different ChatGPT account each timeVerify Setup
opencode-multi-auth statusOutput:
[multi-auth] Account Status
Strategy: round-robin
Accounts: 3
Active: personal
personal (active)
Email: [email protected]
Uses: 12
Token expires: 12/25/2025, 3:00:00 PM
work
Email: [email protected]
Uses: 10
Token expires: 12/25/2025, 3:00:00 PM
backup
Email: [email protected]
Uses: 8
Token expires: 12/25/2025, 3:00:00 PMConfigure OpenCode
Add to your ~/.config/opencode/opencode.json:
{
"plugin": ["@a3fckx/opencode-multi-auth"]
}Or with other plugins:
{
"plugin": [
"oh-my-opencode",
"@a3fckx/opencode-multi-auth"
]
}How It Works
| Feature | Behavior |
|---------|----------|
| Rotation | Round-robin across all accounts per API call |
| Rate Limits | Auto-skips rate-limited account for 5 min, uses next |
| Token Refresh | Auto-refreshes tokens before expiry |
| Models | Auto-discovers GPT-5.x models from OpenAI API |
| Storage | ~/.config/opencode-multi-auth/accounts.json |
CLI Commands
| Command | Description |
|---------|-------------|
| add <alias> | Add new account via OAuth (opens browser) |
| remove <alias> | Remove an account |
| list | List all configured accounts |
| status | Detailed status with usage counts |
| path | Show config file location |
| help | Show help message |
Requirements
- ChatGPT Plus/Pro subscription(s)
- OpenCode CLI
Credits
- Original OAuth implementation: numman-ali/opencode-openai-codex-auth
- Multi-account rotation: @a3fckx
License
MIT
