CodexUse updates and installers: what to expect
CodexUse uses signed builds and a simple in-app restart prompt on the current desktop release line. Here is how updates work today, which platforms the current line supports, and when you need one manual reinstall to move forward cleanly.
How updates flow
- Current Apple Silicon macOS builds check GitHub for updates and download them in the background.
- When a build is ready, you see an in-app card with Restart and Later.
- If you click Later, the card hides for the current session. Restart when you are ready to apply the update.
- On the next launch you get a toast showing the previous and current versions.
brew update and brew upgrade --cask codexuse. The in-app restart updater is for direct app installs, not Homebrew-managed copies.Important upgrade note for older installs
Download links
- macOS Apple Silicon: download from the GitHub releases feed linked on the download button, or install with Homebrew.
- macOS x64 and Linux desktop: not shipped in the current release line.
- Windows: build is still in progress; use the release page to track availability.
- Homebrew:
brew install --cask hweihwang/codexuse/codexuse.
Offline behavior
- The UI and history are local, but Codex CLI usage still requires internet.
- License activation and update downloads need connectivity. If you are offline, the app keeps running with the current build.
What to do if a restart is inconvenient
- Click Later to keep working, then restart when you are ready.
- If you are in the middle of a long task, quit CodexUse and reopen it later to apply the update.
- You can always download the latest installer manually from the releases page if auto-update was blocked by a firewall.
Why is a restart required?
CodexUse updates the desktop shell and local background services together. Restarting ensures the new build and bundled runtime pieces start from a clean state. You choose when to restart.
Does the updater change my profiles or chats?
No. Updates replace the app binary and preserve your existing local profiles, chats, and settings.
Is there a headless update mode?
No. The app always shows the restart notice. If you want to control timing, download the installer manually and run it when you choose.
What if I installed with Homebrew?
Use brew update and brew upgrade --cask codexuse. Do not use the in-app restart updater on a Homebrew-managed install.
What if I am on Linux or an Intel Mac?
The current desktop release line is Apple Silicon macOS only. If you still need terminal workflows on another machine, install the optional codexuse-cli package there and follow the release page for future desktop support changes.