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 autoroll [--threshold=50-100] [--dry-run] [--watch] [--interval=seconds]
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 profile autoroll --dry-run
codexuse profile autoroll --watch --interval=30 --threshold=95
codexuse license status

Cross-device handoff Pro

Common pattern: push from your main laptop, then pull on a second machine so your profiles and config are ready.

# on the second machine
codexuse sync status
codexuse sync pull
codexuse profile list --compact

Notes

• profile add and refresh run codex login (Codex CLI required).
• Use --no-usage to skip live rate-limit fetch.
• profile autoroll runs once by default; use --watch for continuous checks.
• profile autoroll supports --dry-run to preview a switch without applying it.
• In terminal/other clients, profile changes usually apply on the next resumed/new turn, not mid-turn.
• On SSH/headless, login defaults to device auth.
• License state is shared between the desktop app and CLI.
• Cloud sync commands are Pro-only and manual (no background auto-sync).