Welcome to CodexUse
CodexUse is a desktop control center for Codex CLI power users. Everything below is product-focused: shared Chat/Agent workflow, folder-based Projects, local endpoint tooling, no SDKs, and no framework setup.
Start here
- Install CodexUse on Apple Silicon macOS.
- Add a profile and complete OAuth login.
- Start in Chat, switch to Agent when you want machine help, then add a project folder when the work belongs to a repo.
npm install -g codexuse-cli.
Popular paths
Switch accounts safely
Start here if you juggle personal, team, and client accounts and want local profile isolation without relogin loops.
Stay ahead of 429s
Start here if rate limits interrupt longer sessions and you need a reliable path to monitoring, switching, and auto-roll.
Choose Chat, Agent, or Projects
Start here if you want the clean rule of thumb for everyday conversation, machine actions, and repo-bound work.
Pool saved accounts for another app
Start here if another OpenAI-compatible app needs one local API with shared quota, load balancing, and failover across your selected accounts.
Core workflows
Profiles & accounts
Create, switch, and isolate Codex accounts without re-auth.
Projects & sessions
Use Projects for folder-based work and keep Chat/Agent separate for everything else.
Settings & tooling
Accounts Pool
Pool selected accounts behind one local API with shared quota, load balancing, and failover. Pro.
Settings & config
Models, approvals, sandbox mode, config.toml presets, themes, notification sounds, and cloud sync.
MCP & skills
Connect tools and manage skills and AGENTS.md instructions.
CLI reference
Terminal commands for profiles, Accounts Pool, licensing, and the headless daemon.
Telegram remote control
Approve prompts, switch projects, and monitor sessions from your phone via Telegram. Pro.
Integrated terminal
Integrated PTY terminal for the same shell-first flow without leaving the app.