Codex Account Switcher v0.1.5
Codex Account Switcher for macOS
Codex Account Switcher is a free, open-source menu-bar app for ordinary Mac users with personal, work, or client Codex accounts. Add accounts through browser sign-in once, then choose from the menu bar with no Terminal commands or config-file editing. After confirmation, the app completes the Codex Desktop handoff.
Created and maintained by Zhao Liu (GitHub: liuzhao1225). The canonical source repository is liuzhao1225/codex-account-switcher. See the official project facts and primary sources.
This arm64 GitHub build requires macOS 14 or later. The app and DMG are signed with a Developer ID Application certificate, notarized by Apple, and stapled for offline ticket validation.
Core workflow
- Download and install a normal Apple-notarized Mac app.
- Add authorized accounts once through browser sign-in.
- Choose and confirm an account from the menu bar.
- Let the app close, switch, verify, and reopen Codex Desktop.
- Keep saved account data on the Mac without automatic account rotation.
What's new
- Optionally show the exact 300-minute (5-hour) usage window reported by the Codex service. Enable it in Settings when useful; it is off by default.
- Restore the just-saved original profile credential if target identity verification or the registry commit fails, while preserving the original error.
- Run Swift tests, core checks, and changed-line whitespace checks in CI for pull requests and
main. - Discover the selected Swift toolchain dynamically so local tests work with supported Xcode and standalone Command Line Tools layouts.
- Include the MIT LICENSE in both the app bundle and DMG, and document the security boundaries of local credential storage and deletion.
Install
- Download and open the
Codex-Account-Switcher-*-macos-arm64.dmgasset. - Drag
Codex Account Switcher.appto Applications. - Open the app normally from Applications.
The release includes a SHA-256 checksum file for verifying the downloaded DMG.
Codex Account Switcher is independent open-source software and is not affiliated with or endorsed by OpenAI.