Skip to content
Summer sale. 50% off Pro, $19.50 for life.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, Accounts 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 Accounts 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.

# npm install (optional)
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 Accounts 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

Accounts 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 CLI installs are Windows-ready (Windows is not supported yet).

Related

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

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

Start CodexUse free trial
See your own accounts in the rotation
7-day full trial · Apple Silicon macOS · local-first, no API keys
Download CodexUse
Next
Accounts Pool: shared quota for Codex accounts
Accounts Pool turns selected saved Codex accounts into one local API with shared quota, load balancing, and failover for another app.
Cloud sync for Codex profiles and settings
Use CodexUse cloud sync during an active trial or with Pro to push from your main machine and pull profiles, config.toml, and settings on another device.