opencode-codex-multi-account

OpenCode plugin for multi-account ChatGPT/Codex OAuth. It runs inside OpenCode and does not launch kyoli serve.

Use this package for OpenCode Plugin Mode. Use Server Mode (kyoli serve + kyoli install opencode) when the same account pool should also serve Codex CLI, SDK clients, or a dashboard.

Install

Add the plugin to ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-codex-multi-account@latest"]
}

If plugin already exists, append this package to the existing array.

Then use OpenCode's normal auth flow:

opencode auth login

Choose the ChatGPT/Codex multi-auth OAuth method. Run the same command again to add more Codex accounts or open the account management menu.

What it does

Uses OpenCode's built-in openai provider.
Stores accounts under OpenCode's config directory.
Rotates accounts on auth/rate-limit failures.
Refreshes tokens before expiry.
Supports browser OAuth and device-code authentication.

Server Mode migration

kyoli accounts import opencode --dry-run --provider codex
kyoli accounts import opencode --provider codex
kyoli install opencode

Do not keep this plugin enabled for OpenAI while also routing OpenAI through kyoli install opencode, unless you are intentionally comparing both paths.

Checks

No-live contract:

pnpm --filter opencode-codex-multi-account test:contract:native

Full package checks:

pnpm --filter opencode-codex-multi-account typecheck
pnpm --filter opencode-codex-multi-account test
pnpm --filter opencode-codex-multi-account build