Desktop and platform support
CodexUse desktop ships for Apple Silicon macOS, Windows, and Linux. The app has three tabs on every platform. Accounts holds your OpenAI, ChatGPT Web, and custom-model accounts, each with its own isolated Codex home, a status word, and headroom. History lists every local Codex task across accounts and opens each one in the account that owns it. Settings holds shared Codex defaults, Model Providers, Account Pool, Telegram, Cloud Sync, Preferences, CodexUse CLI, and Support.
Which package you need
| Platform | Package | Notes |
|---|---|---|
| macOS 13 or later, Apple Silicon | stable-macos-arm64-CodexUse.dmg, or brew install --cask hweihwang/codexuse/codexuse | Signed and notarized. Updates download in the background and apply on a restart you choose. |
| Windows 11, x64 | win-x64-CodexUse-Setup.zip | Renders in WebView2. The installer is currently unsigned, so Windows may show a SmartScreen warning. Automatic updates are disabled for now, so a newer package is installed by hand. |
| Windows 11, ARM | The same win-x64 package | Windows runs it under x64 emulation. There is no Windows arm64 runtime to build against yet. |
| Ubuntu 24.04, x64 | linux-x64-CodexUse-Setup.tar.gz | Renders in WebKitGTK 4.1. Needs GTK and WebKitGTK 4.1 from your distribution. |
| Ubuntu 24.04, arm64 | linux-arm64-CodexUse-Setup.tar.gz | Native arm64 build, same requirements. Run uname -m if you are unsure which Linux package you need. |
| Intel Mac | Not shipped | Use the cross-platform CodexUse CLI for terminal workflows. |
Each package is built and smoke-tested on its own operating system and architecture. Nothing is cross-compiled, and a package that fails its install-and-relaunch check is not published.
What runs where
| Capability | macOS | Windows | Linux |
|---|---|---|---|
| Unlimited accounts, each with its own isolated Codex home | Yes | Yes | Yes |
| Custom-model accounts through the local gateway | Yes | Yes | Yes |
| ChatGPT Web accounts | Yes | Yes | Yes |
| Account Pool local API | Yes | Yes | Yes |
| Headroom, refill timers, duplicate-identity warnings | Yes | Yes | Yes |
| History of every local Codex task | Yes | Yes | Yes |
| Encrypted Cloud Sync between computers | Yes | Yes | Yes |
| Tray, notifications, file and browser actions | Yes | Yes | Yes, through Ayatana AppIndicator |
| One Codex window per account — Open, Show, outside-window detection | Yes | No | No |
| Auto-roll | Yes | No | No |
| Telegram remote | Yes | No | No |
| Automatic updates | Yes | Not yet — install a newer package manually | Update artifacts ship; the full lifecycle is still in native QA |
The three macOS rows all depend on one thing: OpenAI ships the official Codex app for macOS. CodexUse drives that app to give an account its own window, to roll work to another window, and to answer a Telegram message with one. Outside macOS, CodexUse disables those controls rather than failing at them, and the rest of the app behaves the same.
Where your data lives
- macOS:
~/Library/Application Support/codexuse-desktop - Windows:
%APPDATA%\codexuse-desktop - Linux:
$XDG_CONFIG_HOME/codexuse-desktop, or~/.config/codexuse-desktop
Accounts, settings, and local history stay on the device. App state is kept in local encrypted storage on every platform rather than in Windows Credential Manager or Linux Secret Service. Cloud Sync is manual, opt-in, and passphrase-encrypted, and it never uploads conversation history.
One license, any mix of platforms
A Pro license activates on up to five computers in any mix of macOS, Windows, and Linux. See License & Pro.
Accounts
An account is an OpenAI account, a ChatGPT Web account, or a custom-model account, never a mix. Every account keeps its own Codex home with isolated auth, config, sessions, and logs, on every platform. The Accounts tab shows a status word (Open, Busy, Ready, Low, Needs sign-in, Needs setup), headroom per usage window, and refill timers. On macOS it adds one Codex window per account and Auto-roll.
Settings & tooling
Settings includes Codex defaults. Edit one validated shared TOML source, then add a small account override only when one account needs different model, approval, sandbox, or MCP values. CodexUse protects authentication and custom-model routing values.