CLI reference

Manage profiles, licenses, and cloud sync straight from the terminal.

Install

Optional npm install:

npm install -g codexuse-cli

Verify:

codexuse --version

Commands

codexuse profile list
codexuse profile list --no-usage
codexuse profile list --compact
codexuse profile current
codexuse profile add <name> [--skip-login] [--device-auth] [--login=browser|device]
codexuse profile refresh <name> [--skip-login] [--device-auth] [--login=browser|device]
codexuse profile switch <name>
codexuse profile delete <name>
codexuse profile rename <old> <new>

codexuse license status
codexuse license activate <license-key>

codexuse sync status
codexuse sync pull
codexuse sync push

Examples

codexuse profile list --compact
codexuse profile add Work --login=device
codexuse profile switch Personal
codexuse license status

Notes

• profile add and refresh run codex login (Codex CLI required).
• Use --no-usage to skip live rate-limit fetch.
• On SSH/headless, login defaults to device auth.
• License state lives in ~/.codex/settings.json and is shared with the desktop app.
• Cloud sync commands are Pro-only and manual (no background auto-sync).