Skip to content
50% off Pro: $19.50 onceCODEXUSE50
CodexUse

CodexUse CLI for terminal power users

CLIUpdated October 2026 · 4 min read

Select the Codex CLI account without leaving the terminal. The codexuse CLI manages accounts, Account Pool, and license checks from a laptop or over SSH, no desktop window required.

Key takeaway: The CLI does more than select an account. It controls the Account Pool and checks your license.

When to reach for the CLI

  • Select another account mid-session across multiple clients.
  • Refresh an expired login straight from an SSH session.
  • List accounts, no UI to load.

Install

With the desktop app, open Settings › codexuse in Terminal and click Add codexuse to Terminal. The command ships inside the app, runs on the app's own runtime, and updates with it. On a machine without the app, install the npm package, which needs Node.js 22.13 or later.

# without the app
npm install -g codexuse-cli
# either way, in a new terminal
codexuse doctor

Core workflows

List accounts

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

Select the account the Codex CLI uses next

codexuse profile switch Personal

This selects the account for the next terminal run. It does not move a desktop conversation.

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 sessions list

Account Pool settings, keys, and sessions are the ones the desktop app serves from. The app shows the pooled API base URL under Settings › Account Pool.

What to avoid

  • Running profile add without Codex CLI installed.
  • Adding the same OpenAI account twice. Both entries share one rate limit.
  • Assuming the desktop app opens Codex windows on Windows or Linux. The app installs there, but Codex windows and Auto-roll need macOS.
  • Looking for codexuse best or profile autoroll. Version 7.1 removed both; Auto-roll lives in the app.

Related

CLI reference Account Pool docs Docs: Accounts Open another account without logging out

Do I need the desktop app to use the CLI?

No. Without the app, install codexuse-cli with npm on Node.js 22.13 or later. Account commands work without a desktop window. The Account Pool runtime and custom-model accounts need the desktop app, which is built for Apple Silicon Macs and also runs on Windows 11 x64 and Ubuntu 24.04. Opening Codex windows needs macOS.

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.