Codex++ tweak system for the Codex desktop app
Codex++ patches a local Codex desktop app installation so a loader can run a user-directory runtime and in-app tweaks. It is useful for Codex desktop customization, but it is not an API proxy by itself.
Install and Download
Install from GitHub Releases or use one of the README commands:
brew install b-nnett/codex-plusplus/codexplusplus
codexplusplus install
The README also documents Bun, source bootstrap, and Windows PowerShell install paths. Use codexplusplus status, repair, update, update-codex, or uninstall to inspect, repair, update, restore official Codex updates, or revert.
Key Features
Codex++ patches Codex.app so a loader runs on startup and loads a runtime from the user data directory.
It injects a Tweaks tab into Codex settings so users can enable, disable, and configure tweaks in-app.
It supports tweak folders with a manifest and start/stop lifecycle, default tweaks from GitHub releases, safe mode, doctor, repair, and update commands.
Proxy Setup Checks
Do not treat Codex++ as an API proxy or Base URL tester. It customizes Codex desktop behavior.
Before using it with any proxy workflow, confirm Codex itself can already authenticate and call the intended provider.
Because it patches the desktop app, check the README legal and update notes before installing it on a work machine.
When It Is Useful
- You use the Codex desktop app and want a tweak manager inside its settings UI.
- You understand that Codex++ modifies the local Codex app bundle and may need repair after official Codex updates.
- You want custom keyboard shortcuts, UI tweaks, or your own ESM tweak modules.
- You are comfortable reviewing an unofficial MIT-licensed project before installing it.