Switch Codex CLI accountswithout losing flow.
Local desktop app for fast account switching, rate-limit headroom, shared Chat and Agent workflows, and an optional Accounts Pool API for other OpenAI-compatible tools.
- Multiple saved Codex CLI profilesKeep every account local and switch without repeating auth.
- Fast switching from tray or desktopJump to the right profile in one click when work changes.
- Separate Chat and Agent workflowsKeep everyday prompts away from folder-based project threads.
- Optional local API with failoverPool saved accounts for another OpenAI-compatible app with Pro.
Features
The workflow serious Codex users actually need
Start with instant switching. Add one shared Chat/Agent surface for quick talk or action, keep folder work in Projects, and bring in Accounts Pool when another app should share quota across your saved Codex accounts.
Switch accounts without re-auth
Keep multiple Codex CLI profiles saved locally and switch from tray or window. No logout loop.
See rate-limit headroom
Live usage and reset windows per profile so you know when to switch before the 429. Pro.
Pool quota across accounts
Accounts Pool gives another OpenAI-compatible app one local API that shares quota across your selected accounts, load-balances requests, and fails over automatically from desktop or CLI-managed headless runs. Pro.
Approve from Telegram
Monitor sessions, approve prompts, and switch projects from your phone through a private Telegram bot. Pro.
Projects stay separate from Chat
Use Projects for folder-based work, while Chat and Agent handle quick questions or machine tasks without cluttering project history.
One chat surface, two modes
Stay in the same thread list and composer, use Chat for normal conversation, or switch to Agent when you want CodexUse to act on the machine.
Guides
Start with the exact workflow gap
Use these paths if you already know the pain: account switching, surprise 429s, or pooling saved Codex accounts behind one local API for another app.
Switch accounts safely
Start here if logging out and back in keeps breaking your flow, or if you need work and personal accounts clearly separated.
Stay ahead of 429s
Start here if rate limits interrupt work and you want earlier warning before a session dies mid-task.
Pool accounts for another app
Start here if you want a script, editor extension, or another OpenAI-compatible app to share quota across your saved Codex accounts through one local API.
Community
What developers are saying
From early adopters and real user feedback.
I stopped getting surprised by 429s mid-session. Keeping a backup profile ready with auto-roll changed the workflow.
Early adopter
We pointed one helper app at the pool once, and after that CodexUse spread requests across accounts instead of us babysitting limits by hand.
Beta tester
I installed it for profile switching. Personal, team, and client accounts stay separate without the re-login loop.
Early adopter
Integration
Built for Codex CLI power users
OpenAI OAuth login, local profile isolation, and an optional local API that lets another app share quota across your saved Codex accounts with load balancing and failover, whether you manage it from the desktop app or the CLI.
OpenAI OAuth
Sign in once, profiles stay isolated.
Optional Accounts Pool
Give another app one local API to share quota across selected accounts, with desktop + CLI control and headless daemon hosting when needed.
Profile isolation
Auth and config stay isolated per account.
CodexUse CLI
Built for terminal power users
List profiles, switch accounts, manage Accounts Pool, and run a headless daemon without leaving your terminal.
- Fast profile switching with
codexuse profile switch. - Manage Accounts Pool settings, runtime keys, and daemon inspection from the CLI.
- Device auth for headless/SSH by default, plus manual cloud-sync handoff when you need another machine ready fast.
- Run one headless daemon for Telegram remote control and a pinned Accounts Pool base URL on another machine.
npm install -g codexuse-clicodexuse profile list
codexuse account-pool status
codexuse account-pool keys create --runtime=daemon
codexuse daemon start --port=3773
codexuse sync pull
codexuse license statusPricing
Start free. Upgrade when rate limits become the bottleneck.
Free covers switching and organization. Pro adds live headroom, auto-roll, Accounts Pool for pooled quota and failover in other apps, Telegram remote, and unlimited scale.
Pro
Lifetime licenseOne payment. Yours forever. All future updates included.
Everything in Free, plus:
- Pool selected saved accounts behind one local API for another app
- Shared quota, load balancing, pool keys, and failover when one account runs out
- Manage the pool from desktop or CLI, and host it on a headless daemon when needed
- Live rate-limit monitoring
- Auto-roll to eligible profiles
- Unlimited profiles & projects
- Telegram remote control New
- Manual cloud sync
- One-click MCP & Skills installs
Free
The core workflow, without the relogin pain
Includes:
- 2 Codex CLI profiles
- 2 projects
- Profile switching from window or tray
- Full chat history
- Dark + Light themes
- Usage summary (cost + tokens)
- Config editor & presets
- AI commit messages
- Search, favorites, session pinning
Use Free to prove the switching workflow. Upgrade once for live headroom, Accounts Pool access, automatic profile rollover, Telegram remote, and unlimited profiles/projects.
FAQ
Common questions
Short answers for the switching, install, and upgrade questions that come up most often.
Not for CodexUse itself. CodexUse uses the same OAuth login as the official Codex CLI, so you sign in with your existing OpenAI account. If you turn on Accounts Pool for another app, CodexUse generates a separate local pool key for that client.
Yes. Create a profile for each account and switch between them from the tray, window, or CLI. Auth stays isolated per profile, and Pro can pool selected profiles together so another app can share quota across them instead of making you switch by hand. You can manage that pool from Settings or the CodexUse CLI.
Accounts Pool is a Pro feature that turns selected saved Codex accounts into one local API for another OpenAI-compatible app. That app gets one base URL and one key, while CodexUse shares quota across the selected accounts, load-balances new requests, and fails over when one account runs into limits or runtime trouble. You can control it from the desktop app or the CodexUse CLI, including headless daemon setups.
Current public desktop releases target macOS on Apple Silicon. Intel Mac and Linux desktop builds are not shipped in the current release line. If you only need terminal workflows on another machine, install the optional codexuse CLI separately with npm.
Auto-roll is a Pro feature. Set a usage threshold (e.g. 90%) and CodexUse switches to the next eligible profile when limits are near — only when no active chat is running, so nothing gets interrupted.
Chat and Agent share the same chat surface, thread list, and composer. Use Chat for everyday conversation, switch to Agent when you want CodexUse to inspect files, run commands, or make changes on the machine, and use Projects when the work belongs to a specific folder and should keep its own history and session context.
Free gives you 2 profiles, 2 projects, the shared Chat/Agent surface, profile switching, full chat history, basic usage summary, config editor, notification sounds, and Dark + Light themes. Pro ($19.50 lifetime — 50% off the regular $39 price) adds Accounts Pool with shared quota, load balancing, and failover for other apps, plus unlimited profiles and projects, live rate-limit monitoring, auto-roll, Telegram remote control, one-click MCP & Skills installs, and manual cloud sync. One-time payment, yours forever.
A Pro feature. Connect a Telegram bot to CodexUse and control your workspace from your phone: approve prompts, send messages, switch projects, and monitor running sessions — all through Telegram.
Cloud sync is Pro-only and fully manual. Push from your main machine, then pull on another machine that has the CLI installed. Profiles, config, and settings transfer. Nothing syncs in the background — you control when data moves. A local backup is created before every pull.
Profiles, settings, and local app state stay on your device by default. Codex CLI keeps its own auth and config. Cloud sync is manual and opt-in; it only moves profiles, config, and settings when you explicitly run push.
Yes. One payment of $19.50 (50% off $39) and you own it. All future updates included. No subscriptions, no renewals.
Yes. On Apple Silicon macOS: brew install --cask hweihwang/codexuse/codexuse. Homebrew installs should be upgraded with "brew upgrade --cask codexuse", not the in-app restart updater. If Homebrew gets stuck with either "App source '/Applications/CodexUse.app' is not there" or "It seems there is already an App at '/opt/homebrew/Caskroom/.../CodexUse.app'", run "brew uninstall --cask --force hweihwang/codexuse/codexuse" once, remove any dangling "/Applications/CodexUse.app", then install again.
If you are on CodexUse 2.5.8 or older, redownload the current app manually once and replace the old install. Those older builds are on the pre-3.x updater path, so they do not jump cleanly to the current release line in place.
Changelog
Releases
Latest updates and release notes.
v3.8.1
Latest2026-04-30
brew install --cask hweihwang/codexuse/codexuseCurrent release line
- Desktop releases currently ship for macOS on Apple Silicon only.
- If you are on CodexUse 2.5.8 or older, redownload the current app manually once.
- Project creation now lives in the command palette and the Projects sidebar header is quieter, so add-project, upgrade, and project-control actions use one consistent path instead of competing inline controls.
- Chat work logs open expanded by default again, making tool output and grouped work easier to scan without an extra click on every thread.
- Desktop live updates are steadier after reconnects: stale WebSocket sessions are ignored, terminal resize payloads allow smaller panes, and closed pull requests no longer keep showing as active PR status on the default branch.
- The release path is stricter and simpler behind the scenes: CodexUse now releases from source `main` only, with no source-repo release tags or tag-triggered workflow left in the path.
Get started
Start with free profile switching.
Save 2 profiles and 2 projects locally, then upgrade when you want live rate-limit headroom, auto-roll, Telegram remote, and unlimited scale. Pro is $19.50 lifetime (50% off).
Questions?Email support