Coding CLI macOS, Windows, Linux

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.

codex++ codex tweak manager codex desktop tweaks

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.

Sources

Related tools

Related guides

Related topics

FAQ

Common questions

Is Codex++ an API proxy or Base URL tool?

No. The README describes it as a tweak system for the Codex desktop app. API keys, Base URLs, and provider compatibility still need to be handled by Codex or another configuration layer.

What is the main risk to check before installing Codex++?

It modifies and re-signs the local Codex desktop app. Read the README's update, uninstall, security, and legal notes before using it on a machine where app integrity matters.