CodexUse CLI

Install (npm):

npm install -g codexuse-cli

Commands:

codexuse account-pool status [--runtime=desktop|daemon] [--state-dir=/abs/path] [--port=NNNN]
codexuse account-pool enable
codexuse account-pool disable
codexuse account-pool routing <least-used|round-robin>
codexuse account-pool profiles <list|set|add|remove|reset> [names...]
codexuse account-pool models <list|add|remove|reset> [model-ids...]
codexuse account-pool reasoning <list|add|remove|reset> [values...]
codexuse account-pool fast-mode <list|add|remove|reset> [values...]
codexuse account-pool keys <list|create|revoke> [id]
codexuse account-pool sessions list [--runtime=desktop|daemon] [--state-dir=/abs/path]

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> [--restart-codex]
codexuse profile autoroll [--switch-left=0-50] [--threshold=50-100] [--dry-run] [--watch] [--interval=seconds] [--restart-codex|--no-restart-codex]
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

codexuse daemon start [--port=NNNN] [--telegram-bot-token=<token>] [--project-path=/abs/path]

Notes:

• Requires Codex CLI on PATH for profile add / refresh (runs codex login).
• profile list reads live rate-limit usage via Codex CLI by default.
• Use --no-usage to skip rate-limit fetch.
• Use --compact for names only.
• On headless/SSH, login defaults to device auth. Override with --login=browser.
• Use --skip-login if you already ran codex login.
• First CLI run bootstraps storage migration automatically.
• Accounts Pool settings are shared with the desktop app on the same machine.
• Accounts Pool API keys and live sessions are runtime-specific (desktop vs daemon) because each runtime has its own pool store.
• profile autoroll requires Pro.
• profile autoroll uses live rate-limit usage and switches when current remaining usage is at or below the % left threshold.
• profile autoroll defaults to saved desktop auto-roll switch threshold when available (else 5% left).
• Prefer --switch-left=NN; --threshold=NN remains as the legacy used-percent alias.
• profile autoroll honors the saved desktop "restart official Codex after auto-switch" setting; override with --restart-codex or --no-restart-codex.
• profile switch <name> --restart-codex restarts official Codex after a manual switch.
• profile autoroll --watch keeps polling at --interval seconds (default 30).
• daemon start launches the bundled headless Projects/chat server and can also serve Accounts Pool.
• daemon start requires Bun on PATH because the bundled server runs on Bun.
• Use --port=NNNN when another local client should keep one stable Accounts Pool base URL.
• Set token via --telegram-bot-token=... or CODEXUSE_TELEGRAM_BOT_TOKEN.
• Telegram remote control is only enabled when a bot token is provided.
• --project-path=/abs/path auto-registers that path (if needed) and sets it as the default project for new Telegram chats.