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 core profile workflows and can pull cloud-synced setup onto another machine without opening the desktop app.
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.
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>Move your setup to another machine Pro
If your primary setup is on one device, pull it onto another (for example, Linux over SSH) with cloud sync:
# on second machine
codexuse sync status
codexuse sync pull
codexuse profile list --compactWhat to avoid
- Running
profile addwithout Codex CLI installed. - Using multiple profiles for the same OpenAI account (shares 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.
Can I pull my setup from another machine?
Yes. With Pro cloud sync, push from your main machine, then run codexuse sync pull on the second machine to load profiles, config.toml, and app settings.