A small Windows desktop UI for the installed codex-auth CLI.
This is an unofficial companion app. It does not replace codex-auth; it only wraps common commands in a WPF interface.
- List saved Codex accounts with
codex-auth list --skip-api - Switch accounts with
codex-auth switch <email> - Switch and restart Codex App in one click
- Add accounts with
codex-auth login --device-auth - Remove saved accounts with
codex-auth remove <email> - Show
codex-auth status - Open the local
.codexfolder - Dark mode and light mode
- Adaptive account list height: up to five accounts are shown, then the table scrolls
The app does not read, write, copy, or parse Codex token files directly. All account operations go through the locally installed codex-auth CLI.
By default, the UI lists accounts with --skip-api so account switching does not require the optional codex-auth account/usage API checks.
- Windows
- .NET 8 Desktop Runtime
codex-authinstalled and available onPATH- Codex App if you want the restart button to relaunch the desktop app
Install codex-auth:
npm install -g @loongphy/codex-authInstall the .NET 8 SDK, then run:
.\scripts\build.ps1The published app is written to:
dist\CodexAuthSwitcher.exe
After building, install the app into your user-level Programs folder and create a Start Menu shortcut:
.\scripts\install-user.ps1The app will be installed to:
%LOCALAPPDATA%\Programs\CodexAuthSwitcher
Then search Windows Start for:
Codex Auth Switcher
Project source lives in CodexAuthSwitcher/.
Useful commands:
.\scripts\build.ps1
.\scripts\install-user.ps1This project is intended as a Windows GUI companion for codex-auth. The CLI remains the source of truth for account storage and switching behavior.
MIT
