Auto-roll guardrails: avoid Codex 429s automatically
Turn on auto-roll in CodexUse Pro to switch Codex profiles before rate limits stall your work. Set a % left switch threshold, re-arm level, and low-remaining alert in the app.
Organize Codex sessions by project (not profile)
CodexUse v2 organizes Codex CLI sessions by project with search, favorites, and pinning — not by profile.
Duplicate Codex accounts warning: what it means
CodexUse warns when multiple profiles resolve to one OpenAI identity. Learn why it appears and how to handle duplicate Codex profiles.
CodexUse Homebrew install and update guide
Install CodexUse with Homebrew, verify the CLI landed in PATH, and update cleanly with the official cask workflow on macOS.
Codex login expired? Fix repeated login prompts
Codex keeps asking you to log in again? Fix expired or revoked login state, refresh the right profile, and get back to work without deleting your local setup.
Setting up MCP servers in CodexUse
Configure MCP servers in CodexUse with form controls instead of hand-editing config.toml. Add and manage Model Context Protocol servers safely.
Codex not working? Quick fixes and triage
Codex not working? Step-by-step troubleshooting for Codex CLI issues: authentication errors, rate limits, and common problems. Quick fixes before reinstalling.
Codex on Linux with multiple profiles
Historical Linux workflow note for CodexUse CLI users. Desktop releases target Apple Silicon macOS, but CLI profile workflows still apply on Linux.
Codex profiles: save, rename, and rotate safely
Manage multiple Codex CLI profiles safely. Learn how to save Codex profiles, rename them, and rotate between accounts for rate limit management.
Codex rate limits and 429s: see headroom before the failure
Understand Codex rate limits, why 429s happen, and how to see profile headroom before long runs stall. Switch profiles before sessions fail.
Codex settings without editing config.toml: models, reasoning, MCP
Change Codex models, reasoning effort, approval policy, sandbox mode, and MCP servers from CodexUse without editing config.toml by hand.
CodexUse updates and installers: what to expect
How CodexUse handles updates, restarts, and installers. Learn Apple Silicon macOS support, the 2.5.8 manual upgrade step, and where to download.
Codex usage basics: commands, examples, pitfalls
Codex usage guide: installation, authentication, basic commands, configuration. Learn how to use the Codex CLI effectively with real examples.
How to connect another app to your pooled Codex accounts
Connect another OpenAI-compatible app to Accounts Pool so it gets one local API, pooled quota across selected accounts, load balancing, and failover.
Accounts Pool: shared quota and load balancing for saved Codex accounts
Accounts Pool turns selected saved Codex accounts into one local API with shared quota, load balancing, and failover for another app.
CodexUse and Claude Code: not supported in v2
CodexUse v2 is a Codex CLI desktop app for OpenAI workflows. It does not run Claude Code or Anthropic models.
CodexUse CLI for terminal power users
Use the CodexUse CLI to switch profiles, manage Accounts Pool, and run a headless daemon without opening the desktop app.
Cloud sync: keep profiles, config, and settings across devices
Use CodexUse Pro cloud sync to push from your main machine and pull profiles, config.toml, and settings on another device with pre-pull backups.
Quick switcher and keyboard shortcuts in CodexUse
Use Cmd/Ctrl+K for the profile quick switcher, press ? for Help, and use core shortcuts for navigation and chat in CodexUse.
CodexUse for Cursor users: keep Codex local and multi-account
Use Cursor for editor flow, then use CodexUse to switch Codex accounts without re-auth, monitor rate limits, and keep local-first control.
CodexUse for JetBrains users: keep the CLI workflow local and organized
Use JetBrains for coding and CodexUse for local Codex CLI account switching, rate-limit visibility, and project control.
CodexUse for Windsurf users: keep Codex local and account-aware
Use Windsurf for editor flow, then use CodexUse to switch Codex accounts without re-auth, monitor rate limits, and keep local project control.
Integrated terminal: PTY tabs in your workspace
CodexUse 2.5 adds a terminal dock with full PTY sessions. Create tabs, resize the panel, and run commands without leaving your workspace.
Multi-account auth: OpenAI in one app
Use multiple OpenAI logins in one desktop app. CodexUse v2 is OpenAI-only and switches Codex CLI accounts without re-auth.
CodexUse notifications and sound alerts
CodexUse 2.5 adds system notifications when chat needs a response, success and error sounds, and in-app rate-limit radar.
Remote access: control CodexUse over Tailscale
CodexUse 2.5 runs a TCP daemon that lets you control your workspace from another machine or phone over your Tailscale network.
Telegram remote control: manage CodexUse from your phone
Connect a Telegram bot to CodexUse and approve prompts, switch projects, and monitor sessions from your phone.
Themes and customization: Dark and Light
CodexUse ships two theme modes — Dark and Light — with comprehensive surface palettes, reduced-transparency accessibility, and system preference support.
Session organization: search, favorites, and pinning
Organize CodexUse sessions by project with search, favorites, pinning, rename, and delete so local Codex history stays easy to scan.
CodexUse vs CodexBar vs the vanilla Codex CLI
Compare CodexUse, CodexBar, and vanilla Codex CLI by account switching, rate-limit visibility, local control, and background help.
GitHub Agent HQ vs a local Codex workflow
Use GitHub Agent HQ for hosted GitHub work. Use CodexUse for local accounts, local files, rate-limit visibility, and project control.
Official Codex app orchestrator for multiple accounts
Orchestrate official Codex app windows with profile-matched accounts, plus Codex CLI profiles, rate-limit headroom, and safe restart behavior in CodexUse.
Switch Codex accounts without logging out
Stop logging out of Codex just to change accounts. Save multiple profiles, switch the active one locally, and keep work, client, and personal sessions separate.
Start with the exact problem
Orchestrate official Codex app windows
Use these if your main pain is knowing which official Codex app window belongs to which account, then focusing, stopping, restarting, or monitoring the right one.
Switch and isolate accounts
Use these if your main pain is relogin loops, duplicate accounts, or keeping personal, team, and client work separate.
Pool saved accounts for another app
Use these when another OpenAI-compatible app needs one local API with shared quota, load balancing, and failover across your selected accounts.
Stay ahead of rate limits
Use these when 429s interrupt work, a login looks broken but the real issue is quota, or you want auto-roll guardrails.
About these guides
These guides are written for developers who use the official Codex app and Codex CLI for real work. Every article:
- Uses actual Codex app and CLI workflows
- Explains what the native app and CLI can and cannot do
- Shows how CodexUse fills gaps in multi-account orchestration, pooled endpoint, and monitoring features
- Includes troubleshooting tables for common issues
- Links you to the next best docs page or workflow guide