Skip to content
github-actions[bot] edited this page Jul 14, 2026 · 4 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
Install codex-switch and add my first account Getting started
Manage accounts, watch quota, select, launch, or run the daemon Feature guide
Look up an exact command, flag, or TUI shortcut Command reference
Configure paths, proxy, cache, daemon, or launch behavior Configuration
Update the binary or move between release channels Updating
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

Contribute

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

Documentation model

These Wiki pages are the user and contributor documentation for codex-switch. Their sources live in docs/wiki/ on the dev branch, are reviewed in pull requests with the code, and are published here automatically. Maintainer-only material stays in the repository: the release process and the changelog. 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