-
-
Notifications
You must be signed in to change notification settings - Fork 3
FAQ
No, and this is permanent by design. OS keyrings provide no locking or atomic-replace semantics, and Codex's keyring entry format is an undocumented internal layout that has already changed between versions and platforms. Codex must use cli_auth_credentials_store = "file"; if it previously used a keyring store, switch the setting and log in again. See why only the file store is supported.
No. Codex reads authentication at startup. Restart Codex, or use codex-switch launch for a new process.
Saved profiles and application state default to ~/.codex-switch; the live Codex file defaults to ~/.codex/auth.json. Custom API providers live under ~/.codex-switch/providers/<alias>/ (provider.toml, generated models.json, isolated codex-home/). CODEX_SWITCH_HOME and CODEX_HOME relocate them independently.
No. Current Codex only accepts wire_api = "responses". DeepSeek's official API is Chat Completions. Save an OpenRouter (or other Responses-capable gateway) provider and set --model to that gateway's slug. See Custom API providers.
No. use only stages a ChatGPT auth.json for the next Codex process. A provider is applied only by codex-switch launch <alias>, for that one Codex invocation. A later bare codex run is unchanged.
No. provider add reads it from a hidden prompt or --api-key-stdin. Launch injects it into the Codex child environment under a codex-switch-owned variable. list, show, JSON, and the TUI print a redacted form only.
No. Inactive profiles are archived under deleted-profiles/. The active profile cannot be deleted.
No. It is an optional Beta feature. codex-switch use, list, launch, and the TUI work without it.
Releases use calendar versions in the form YYYYMMDD.N.0. Rolling dev builds end in -dev. Calendar versions are a normal upgrade from the earlier 0.0.x series; see Updating.
Use the rolling dev channel only when you are prepared to test prerelease behavior. Follow Testing development releases for installation, verification, rollback, and issue-reporting steps.
Not currently. Archives are checked against SHA256 files from the same GitHub Release, which detects corruption but shares the Release trust domain.
These Wiki pages are generated from docs/wiki/ on the dev branch. Open a pull request against those sources; do not edit the published Wiki directly.
- New installation: Getting started.
- Daily workflows: Feature guide.
- Custom API providers: Custom API providers.
- Errors and recovery: Troubleshooting.