CodexUse logo CodexUse
Download
Docs hub

CodexUse Docs

Learn the CodexUse workflow end-to-end: official Codex app orchestration, Chat/Agent, profiles, projects, Accounts Pool, optional cloud sync, MCP servers, and the CLI.

Get started CLI reference
Home › Docs

Welcome to CodexUse

CodexUse is a desktop orchestrator for Codex app and CLI power users. Everything below is product-focused: official app windows, shared Chat/Agent workflow, folder-based Projects, local endpoint tooling, no SDKs, and no framework setup.

Last updated: 2026-04-19 Current docs No API keys
What's new in current builds: Codex Apps orchestrates profile-matched official Codex app windows, and Chat now has one shared Chat/Agent surface. Start in Codex Apps, Desktop overview, or Projects & sessions.

Start here

  1. Install CodexUse on Apple Silicon macOS.
  2. Add a profile and complete OAuth login.
  3. Start in Chat, switch to Agent when you want machine help, then add a project folder when the work belongs to a repo.
Install note: Current desktop releases target Apple Silicon macOS. If you are on an Intel Mac, Linux, or an old CodexUse build at 2.5.8 or older, read the updates and installers guide before upgrading. For terminal workflows, install the CLI manually with npm install -g codexuse-cli.

Popular paths

Orchestrate official Codex app windows

Start here if you want each official Codex app window mapped to the right saved account, with focus, stop, restart, launch, and live state controls.

Codex Apps docs Official app guide Profiles docs

Switch accounts safely

Start here if you juggle personal, team, and client accounts and want local profile isolation without relogin loops.

Profiles docs Switch accounts Login expiry guide

Stay ahead of 429s

Start here if rate limits interrupt longer sessions and you need a reliable path to monitoring, switching, and auto-roll.

Profiles docs 429 guide Auto-roll guardrails

Choose Chat, Agent, or Projects

Start here if you want the clean rule of thumb for everyday conversation, machine actions, and repo-bound work.

Desktop overview Projects & sessions Settings & config

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.

Accounts Pool docs Launch guide Client setup guide

Core workflows

Profiles & accounts

Create, switch, and isolate Codex accounts without re-auth.

Codex Apps

Orchestrate official Codex app windows by profile: launch, focus, stop, restart, and monitor.

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.

Support

Troubleshooting License & Pro Guides & deep dives