CodexUse CLI for terminal power users
I wanted a zero-UI way to switch Codex accounts on a laptop and over SSH. The CodexUse CLI now covers the core profile workflows without opening the desktop app.
Key takeaway: The CLI is for fast profile control, not full chat UI. Pair it with the desktop app when you need sessions, notes, or analytics.
When the CLI shines
- Switching accounts during multi-client work.
- Refreshing an expired login from an SSH session.
- Listing profiles fast without loading a UI.
Install
Recommended: install from the desktop app (Settings → CLI) so the command is linked into PATH.
# npm install (optional)
npm install -g codexuse-cli
codexuse --version
Core workflows
List profiles
codexuse profile list
codexuse profile list --compact
codexuse profile list --no-usageAdd or refresh login
codexuse profile add Work --login=device
codexuse profile refresh Work --login=browserSwitch accounts
codexuse profile switch PersonalLicenses in the terminal
codexuse license status
codexuse license activate <license-key>What to avoid
- Running
profile addwithout Codex CLI installed. - Using multiple profiles for the same OpenAI account (splits rate limits).
- Assuming CLI installs are Windows-ready (Windows is not supported yet).
Related
Do I need the desktop app to use the CLI?
You can install the CLI via npm, but the desktop app gives the easiest PATH install and profile UI.
Does the CLI require API keys?
No. It uses the same OAuth login flow as the Codex CLI.
Will the CLI read my rate limits?
Yes, unless you pass --no-usage. Live usage requires Codex CLI to be reachable.