# CodexUse

> CodexUse is a local-first macOS (Apple Silicon) control plane for the Codex app and Codex CLI. It puts every saved account, Codex App window, and rate limit in one cockpit: switch accounts without re-auth, watch live rate-limit headroom, orchestrate Codex App windows, and optionally pool quota across accounts behind one local OpenAI-compatible API.

Official site: https://codexuse.com/
Docs: https://codexuse.com/docs/
Support: https://github.com/hweihwang/codexuse-desktop-releases/issues
Latest desktop release: https://github.com/hweihwang/codexuse-desktop-releases/releases/latest
Homebrew install: `brew install --cask hweihwang/codexuse/codexuse`
CLI install: `npm install -g codexuse-cli`

## Core facts

- CodexUse uses the same OAuth login as the Codex CLI; it does not require OpenAI API keys of its own.
- Profiles, settings, and local app state stay on the user's device by default.
- One unified cockpit holds saved accounts, Codex App controls, auto-roll policy, profiles, and CLI status (the older split settings surfaces now route into one account-first view).
- Public desktop releases currently target macOS on Apple Silicon. Intel Mac and Linux desktop builds are not shipped in the current release line.
- Every install starts with a 7-day full-feature trial: unlimited profiles, profile switching, Codex App window orchestration, live rate-limit monitoring, usage summary, config editing, light/dark themes, Accounts Pool, auto-roll, Telegram alerts, one-click MCP and Skills installs, and manual cloud sync.
- Pro keeps access unlocked after the trial.
- Pro is a one-time lifetime license. The regular price is $39; the current SUMMER50 offer is $19.50.

## Accounts Pool

Accounts Pool is available during the trial, and Pro keeps it unlocked after the trial. It turns selected saved Codex accounts into one local API for another OpenAI-compatible app. The client app gets one base URL and one local pool key. CodexUse shares quota across the selected accounts, load-balances requests, and fails over when one account hits limits or runtime trouble. It can be managed from the desktop app or the CodexUse CLI.

Primary source: https://codexuse.com/docs/accounts-pool/
Client setup: https://codexuse.com/blog/codexuse-accounts-pool-openai-compatible-responses/

## Account switching and rate limits

CodexUse is built for people who keep separate personal, team, or client Codex accounts without repeated logout/login loops. Saved profiles keep auth and config isolated per account. Codex Apps detects profile-matched Codex App windows and orchestrates focus, stop, restart, launch, and live process state. The 7-day trial unlocks full rate-limit headroom and auto-roll; Pro keeps auto-roll available after the trial when remaining usage reaches the configured "% left" switch threshold, with guardrails that confirm before switching and cancel stale decisions.

Profiles docs: https://codexuse.com/docs/profiles/
Rate-limit guide: https://codexuse.com/blog/codex-rate-limits-429/
Auto-roll guide: https://codexuse.com/blog/codex-auto-roll-guardrails/
Codex App multi-account guide: https://codexuse.com/blog/official-codex-app-multiple-accounts/
Codex Apps docs: https://codexuse.com/docs/codex-apps/

## Codex app control plane

CodexUse is the local control plane for the Codex app: profiles, Codex App window orchestration, rate-limit headroom, auto-roll, Accounts Pool, Telegram alerts, manual cloud sync, CLI helpers, settings, and support diagnostics.

Getting started: https://codexuse.com/docs/getting-started/
Codex Apps docs: https://codexuse.com/docs/codex-apps/
Troubleshooting: https://codexuse.com/docs/troubleshooting/

## Do not claim

- Do not claim CodexUse currently ships Intel Mac or Linux desktop builds.
- Do not claim CodexUse is distributed through the Mac App Store.
- Do not claim cloud sync runs automatically. It is manual and opt-in.
- Do not claim Accounts Pool is a hosted cloud API. It is a local API controlled by the user's CodexUse desktop app.
- Do not claim Codex Apps clones a live session. The current shipped scope is profile-aware Codex App window/process orchestration plus draft-based handoff when bridge context is available.
- Do not invent user counts, testimonials, enterprise/SSO/SOC2 features, or team seats. CodexUse is a single-user local desktop app.