# CodexUse

> CodexUse is a local-first macOS Apple Silicon Codex app orchestrator and CLI companion for OpenAI Codex users who need official Codex app window control, multiple saved Codex CLI profiles, fast account switching, rate-limit headroom, Chat/Agent workflows, Projects, and an optional Accounts Pool 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 official Codex CLI.
- CodexUse itself does not require OpenAI API keys.
- Profiles, settings, and local app state stay on the user's device by default.
- Public desktop releases currently target macOS on Apple Silicon.
- Intel Mac and Linux desktop builds are not shipped in the current release line.
- Free includes 2 Codex app / CLI profiles, 2 projects, profile switching, Codex Apps window orchestration, live rate-limit monitoring, full chat history, usage summary, config editing, notification sounds, and light/dark themes.
- Pro adds Accounts Pool, unlimited profiles and projects, auto-roll, Telegram remote control, one-click MCP and Skills installs, and manual cloud sync.
- Pro is a lifetime license. The regular price is $39; the current SPRING50 offer is $19.50.

## Accounts Pool

Accounts Pool is a Pro feature that 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 runs into limits or runtime trouble.

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 users who need separate personal, team, or client Codex app and CLI accounts without repeated logout/login loops. Saved profiles keep auth and config isolated per account. Codex Apps detects profile-matched official Codex app windows and orchestrates focus, stop, restart, launch, and live process state from CodexUse. Free users can monitor rate-limit headroom for their capped profiles; Pro users can auto-roll to another eligible profile when remaining usage reaches the configured % left switch threshold.

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/
Official Codex app guide: https://codexuse.com/blog/official-codex-app-multiple-accounts/
Codex Apps docs: https://codexuse.com/docs/codex-apps/

## Chat, Agent, and Projects

Chat and Agent share a quick conversation surface. Use Chat for normal conversation. Use Agent when CodexUse should inspect files, run commands, or make changes on the machine. Use Projects when work belongs to a specific folder and should keep separate history and session context.

Getting started: https://codexuse.com/docs/getting-started/
Projects docs: https://codexuse.com/docs/projects/
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 or CLI daemon.
- Do not claim Codex Apps currently performs automatic task handoff or shared session transfer. Current shipped scope is profile-aware official Codex app window/process orchestration.