Skip to content
github-actions[bot] edited this page Jul 14, 2026 · 5 revisions

codex-switch Wiki

codex-switch manages multiple local OpenAI Codex CLI logins, shows quota state, and selects an account for the next Codex session.

Required: Codex must use cli_auth_credentials_store = "file". Start with Getting started before importing or switching accounts.

Start here

Choose your task

I want to… Start here
Add, import, inspect, or switch accounts Feature guide
Install or test the rolling dev build Testing development releases
Diagnose an error or recover a profile Troubleshooting
Check a short behavior or security answer FAQ
Read the complete command and configuration docs Documentation index

Contribute

  1. Prepare a development environment.
  2. Understand state ownership and safety boundaries.
  3. Follow the contribution and verification contract.

Documentation model

The Wiki is a concise navigation layer. Detailed behavior lives in the reviewed dev branch documentation, which is published alongside these Wiki sources. Stable installers and binaries come from GitHub Releases.

Do not publish auth files, profile files, tokens, unredacted debug output, proxy credentials, account IDs, email addresses, or workspace names.

Clone this wiki locally