Skip to content
Summer sale. 50% off Pro, $19.50 for life. Desktop app: Apple Silicon Mac only.SUMMER50
CodexUse

CodexUse CLI for terminal power users

CLIUpdated May 2026 · 4 min read

Switch Codex accounts without leaving the terminal. The codexuse CLI drives profiles, Account Pool, license checks, and cloud sync from a laptop or over SSH, no desktop window required.

Key takeaway: The CLI is more than profile switching. It controls the Account Pool, checks your license, and hands a setup to another machine over sync.

When to reach for the CLI

  • Switch accounts mid-session across multiple clients.
  • Refresh an expired login straight from an SSH session.
  • List profiles instantly, no UI to load.

Install

Install the CLI manually with npm, then verify it is on your PATH.

# install
npm install -g codexuse-cli
codexuse --version

Core workflows

List profiles

codexuse profile list
codexuse profile list --compact
codexuse profile list --no-usage

Add or refresh login

codexuse profile add Work --login=device
codexuse profile refresh Work --login=browser

Switch accounts

codexuse profile switch Personal

Licenses in the terminal

codexuse license status
codexuse license activate <license-key>

Manage Account Pool from the terminal Pro

Point another OpenAI-compatible app at one local API and let CodexUse share quota across accounts. Configure and inspect that pool from the CLI:

codexuse account-pool status
codexuse account-pool profiles list
codexuse account-pool keys create
codexuse account-pool keys create --runtime=desktop
codexuse account-pool sessions list

Account Pool settings, keys, and sessions belong to the desktop app runtime store. Use the desktop app to view the current pooled API base URL.

Move your setup to another machine Pro

Keep your primary setup on one device and pull it onto another (for example, Linux over SSH) with cloud sync:

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

What to avoid

  • Running profile add without Codex CLI installed.
  • Using multiple profiles for the same OpenAI account (shares rate limits).
  • Assuming the desktop app runs on Windows. The CLI does; the desktop app does not.

Related

CLI reference Account Pool docs Profiles & accounts Cloud sync guide Switch accounts without logout

Do I need the desktop app to use the CLI?

No. Install codexuse-cli with npm. Profile and sync commands work without a desktop window; Codex App window control remains desktop-only.

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, push from your main machine, then run codexuse sync pull on the second machine to load profiles, config.toml, and app settings.