Orchestrate official Codex app profileswithout the account chaos.
Local desktop app for a fleet of official Codex windows, Codex CLI profiles, rate-limit headroom, Chat/Agent workflows, and optional Accounts Pool failover for OpenAI-compatible tools.
- Official Codex app orchestratorLaunch, focus, stop, and restart profile-matched Codex windows.
- Profile-aware window fleetRun personal, work, and client Codex windows side by side.
- CLI, tray, and desktop routingMove the active profile before work changes or limits bite.
- Optional local API with account failoverPool saved accounts for another OpenAI-compatible app. Pro.
Features
The workflow serious Codex users actually need
Start with official Codex app window orchestration and instant account switching. Add Chat/Agent for quick work, keep folder work in Projects, and use Accounts Pool when another app should share quota across saved Codex accounts.
Orchestrate official Codex app windows
Launch, focus, stop, and restart profile-matched official Codex instances from one local CodexUse orchestrator.
Switch Codex accounts without re-auth
Keep Codex CLI and official Codex app profiles saved locally, then move between personal, work, and client contexts without the logout loop.
See rate-limit headroom
Live usage and reset windows per profile so you know when to switch before the 429.
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: official app window sprawl, account switching, surprise 429s, or pooling saved Codex accounts behind one local API for another app.
Orchestrate official Codex app windows
Start here if you want each official Codex window mapped to the right saved account, with focus, stop, restart, and launch controls.
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 app and CLI power users
Official Codex app process orchestration, OpenAI OAuth login, local profile isolation, and an optional local API that lets another app share quota across saved Codex accounts with load balancing and failover.
Codex Apps
Orchestrate profile-matched official Codex windows: launch, focus, stop, restart, and monitor.
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
OAuth 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 Codex work spans accounts.
Free covers 2 profiles, Codex Apps orchestration, and live headroom. Pro adds auto-roll, Accounts Pool for pooled quota and failover, 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
- 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 app / CLI profiles
- 2 projects
- Profile switching from window, tray, or CLI
- Official Codex app orchestration for saved profiles
- Live rate-limit monitoring
- Full chat history
- Dark + Light themes
- Usage summary (cost + tokens)
- Config editor & presets
- AI commit messages
- Search, favorites, session pinning
Use Free for 2 profiles, 2 projects, Codex Apps orchestration, and live headroom. Upgrade once for 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, CLI, or Codex Apps settings. CodexUse can also orchestrate official Codex app windows for profile-matched accounts. Pro can pool selected profiles together so another app can share quota across them instead of making you switch by hand.
Yes on macOS. Codex Apps can launch official Codex app windows with saved CodexUse profiles, detect already-open matching windows, and show which profile is running. Free is still capped at 2 saved profiles, so it can orchestrate up to those 2 profile windows.
Yes. Codex Apps detects profile-matched official Codex app windows, shows their running state, and lets you focus, stop, restart, or launch windows from CodexUse. Today that means profile-aware process orchestration; auto-handoff and shared session transfer are roadmap directions, not shipped behavior.
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 % left switch threshold, optionally rank eligible profiles, and CodexUse switches to the next profile when the active account reaches that remaining-usage level.
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, Codex Apps window orchestration, live rate-limit monitoring, 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, 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.9.9
Latest2026-05-27
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.
- Codex Apps can now activate reset windows for saved profiles with one confirmed action. CodexUse sends a minimal Codex request for each launchable profile, refreshes rate-limit data afterward, and shows completed, skipped, or failed activation results per account.
- Official Codex app profile switching is safer when restarts overlap. CodexUse now treats the latest requested target as the owner, cancels stale restart debt, and avoids an old retry relaunching the wrong account after you manually switch profiles.
- The Codex Apps sync card now merges live window observations with saved restart state, tracks reset-window activation events, and can open the event log directly for faster diagnosis of stale or mismatched app-account state.
- Reset-window activation uses an isolated temporary Codex home and only writes refreshed auth back when the source auth has not changed in flight, preventing stale token data from overwriting a newer profile switch.
Get started
Start with free Codex app orchestration.
Save 2 profiles and 2 projects locally, orchestrate official Codex app windows, and see live rate-limit headroom. Upgrade for auto-roll, Accounts Pool, Telegram remote, and unlimited scale. Pro is $19.50 lifetime (50% off).
Questions?GitHub support