Every Codex account, one click away.
Save multiple Codex CLI profiles locally, swap instantly from tray or window, and upgrade for live rate-limit radar plus auto-roll before 429s slow you down.
Features
The workflow serious Codex users actually need
Start with instant account switching. Add rate-limit radar, auto-roll, project-based history, and remote control when the workflow gets heavier.
Switch accounts without re-auth
Keep multiple Codex CLI profiles saved locally and switch from tray or window. No logout loop.
See rate-limit headroom
Live usage and reset windows per profile so you know when to switch before the 429. Pro.
Approve from Telegram
Monitor sessions, approve prompts, and switch projects from your phone through a private Telegram bot. Pro.
Projects keep work separate
Recent runs, model picker, and collaboration modes stay organized per project instead of one mixed global history.
Searchable session history
Pin, favorite, rename, and search conversations without losing track of client, team, or personal work.
MCP and skills in one place
Install MCP servers, manage skills and AGENTS.md, and keep local tooling aligned across projects.
Manual sync between machines
Push profiles, config, and settings from one device, then pull on another only when you choose. Pro.
Real terminal, docked
Full PTY tabs inside the workspace for the same shell-first flow, without bouncing between apps.
Guides
Start with the exact workflow gap
Use these paths if you already know the pain: account switching, 429s, or fitting Codex into an existing editor-heavy setup.
Switch accounts safely
Start here if your main pain is relogin loops, duplicate accounts, or keeping client and personal work separate.
Stay ahead of 429s
Start here if rate limits interrupt work and you need a cleaner monitor-switch-auto-roll workflow.
Fit Codex into your stack
Start here if you already work in an IDE or hosted agent surface and want a local-first Codex companion flow.
Community
What developers are saying
From our Discord community and early adopters.
I stopped getting surprised by 429s mid-session. Keeping a backup profile ready with auto-roll changed the workflow.
Early adopter
Telegram remote is useful because it works from my phone without any webhook or public-server setup.
Discord member
I installed it for profile switching. Personal, team, and client accounts stay separate without the re-login loop.
Beta tester
Integration
Built for Codex CLI power users
OpenAI OAuth login, Codex-first models, and local profile isolation. No API keys needed.
OpenAI OAuth
Sign in once, profiles stay isolated.
Codex models
GPT-5.3-Codex, GPT-5.2-Codex, GPT-5.1-Codex-Max, GPT-5.1-Codex-Mini, GPT-5.2.
Profile isolation
Auth and config stay isolated per account.
CodexUse CLI
Built for terminal power users
List profiles, switch accounts, refresh logins, and pull your setup onto another machine without leaving your terminal.
- Fast profile switching with
codexuse profile switch. - Device auth for headless/SSH by default.
- Push on your main laptop, then run
codexuse sync pullon another CLI setup. - License state is shared between the desktop app and CLI.
npm install -g codexuse-clicodexuse profile list
codexuse profile add Work --login=device
codexuse profile switch Personal
codexuse sync status
codexuse sync pull
codexuse license statusPricing
Start free. Upgrade when rate limits become the bottleneck.
Free covers switching and organization. Pro adds live rate-limit radar, auto-roll, Telegram remote, and unlimited scale.
Pro
Lifetime licenseOne payment. Yours forever. All future updates included.
Everything in Free, plus:
- Live rate-limit monitoring
- Auto-roll to eligible profiles
- Unlimited profiles & projects
- Telegram remote control New
- Manual cloud sync
- Advanced analytics
- One-click MCP & Skills installs
Free
The core workflow, without the relogin pain
Includes:
- 2 Codex CLI profiles
- 2 projects
- Profile switching from window or tray
- Full chat history
- Dark + Light themes
- Usage summary (cost + tokens)
- MCP server controls
- Config editor & presets
- AI commit messages
- Integrated terminal with PTY tabs
- Search, favorites, session pinning
Use Free to prove the switching workflow. Upgrade once for live headroom, automatic profile rollover, Telegram remote, and unlimited profiles/projects.
FAQ
Common questions
Short answers for the switching, install, and upgrade questions that come up most often.
No. CodexUse uses the same OAuth login as the official Codex CLI. Sign in with your existing OpenAI account — no API keys, no tokens to manage.
Yes. Create a profile for each account and switch between them from the tray, window, or CLI. Auth stays isolated per profile.
Current public desktop releases target macOS on Apple Silicon. Intel Mac and Linux desktop builds are not shipped in the current release line. If you only need terminal workflows on another machine, install the optional codexuse CLI separately with npm.
Auto-roll is a Pro feature. Set a usage threshold (e.g. 90%) and CodexUse switches to the next eligible profile when limits are near — only when no active chat is running, so nothing gets interrupted.
Free gives you 2 profiles, 2 projects, profile switching, full chat history, basic usage summary, MCP manual setup, config editor, integrated terminal, notification sounds, and Dark + Light themes. Pro ($19.50 lifetime — 50% off the regular $39 price) adds unlimited profiles and projects, live rate-limit monitoring, auto-roll, Telegram remote control, advanced analytics, one-click MCP & Skills installs, and manual cloud sync. One-time payment, yours forever.
A Pro feature. Connect a Telegram bot to CodexUse and control your workspace from your phone: approve prompts, send messages, switch projects, and monitor running sessions — all through Telegram.
Cloud sync is Pro-only and fully manual. Push from your main machine, then pull on another machine that has the CLI installed. Profiles, config, and settings transfer. Nothing syncs in the background — you control when data moves. A local backup is created before every pull.
Profiles, settings, and local app state stay on your device by default. Codex CLI keeps its own auth and config. Cloud sync is manual and opt-in; it only moves profiles, config, and settings when you explicitly run push.
Yes. One payment of $19.50 (50% off $39) and you own it. All future updates included. No subscriptions, no renewals.
Yes. On Apple Silicon macOS: brew install --cask hweihwang/codexuse/codexuse. If an old upgrade fails with "App source '/Applications/CodexUse.app' is not there", run "brew uninstall --cask --force hweihwang/codexuse/codexuse" once, then install again.
If you are on CodexUse 2.5.8 or older, redownload the current app manually once and replace the old install. Those older builds are on the pre-3.x updater path, so they do not jump cleanly to the current release line in place.
Changelog
Releases
Latest updates and release notes.
v3.1.5
Latest2026-04-01
brew install --cask hweihwang/codexuse/codexuseCurrent release line
- Desktop releases currently ship for macOS on Apple Silicon only.
- If you are on CodexUse 2.5.8 or older, redownload the current app manually once.
- Thread terminal selections are first-class chat context now: pick exact line ranges from the terminal drawer and they show up as inline chips in the composer instead of forcing manual copy and paste.
- Those terminal context snippets now persist with the draft and materialize correctly when you send, with clearer expired-context handling if the underlying terminal output is no longer available.
- Imported Codex CLI threads are less noisy in the UI: duplicate origin badges were removed from thread chrome and replaced with one clearer notice at the top of the conversation.
- Local mac release recovery is sturdier behind the scenes: if a notarized app bundle already exists, CodexUse can restaple it and rebuild the DMG plus updater assets without rerunning the whole packaging pass.
Get started
Start with free profile switching.
Save 2 profiles and 2 projects locally, then upgrade when you want live rate-limit headroom, auto-roll, Telegram remote, and unlimited scale. Pro is $19.50 lifetime (50% off).