codex-plusplus
Codex++ tweak system for the Codex desktop app
File Explorer
- tweak-store-review.md
- ci.yml
- codexplusplus.js
- 0.1.2.md
- 0.1.3.md
- 0.1.4.md
- 0.1.5.md
- 0.1.7.md
- api-reference.md
- distribution-debugging.md
- getting-started.md
- manifest.md
- mcp.md
- native-bridge.md
- README.md
- runtime-lifecycle.md
- typescript-and-bundling.md
- ui-and-dom.md
- ARCHITECTURE.md
- OWL-BRIDGE-ROADMAP.md
- OWL-RUNTIME.md
- TROUBLESHOOTING.md
- WRITING-TWEAKS.md
- codexplusplus.rb
- codexpp_native_host.node
- index.d.ts
- index.js
- index.js.map
- manager.d.ts
- manager.js
- manager.js.map
- react-hook.d.ts
- react-hook.js
- react-hook.js.map
- settings-injector.d.ts
- settings-injector.js
- settings-injector.js.map
- tweak-host.d.ts
- tweak-host.js
- tweak-host.js.map
- browser-ui.d.ts
- browser-ui.js
- browser-ui.js.map
- codex-runtime-probe.d.ts
- codex-runtime-probe.js
- codex-runtime-probe.js.map
- logging.d.ts
- logging.js
- logging.js.map
- main.d.ts
- main.js
- main.js.map
- mcp-sync.d.ts
- mcp-sync.js
- mcp-sync.js.map
- native-bridge.d.ts
- native-bridge.js
- native-bridge.js.map
- native-paths.d.ts
- native-paths.js
- native-paths.js.map
- preload.js
- storage.d.ts
- storage.js
- storage.js.map
- tweak-discovery.d.ts
- tweak-discovery.js
- tweak-discovery.js.map
- tweak-lifecycle.d.ts
- tweak-lifecycle.js
- tweak-lifecycle.js.map
- tweak-store.d.ts
- tweak-store.js
- tweak-store.js.map
- watcher-health.d.ts
- watcher-health.js
- watcher-health.js.map
- loader.cjs
- copy-assets.mjs
- browser-ui.ts
- create-tweak.ts
- debug.ts
- dev-tweak.ts
- doctor.ts
- install.ts
- repair.ts
- safe-mode.ts
- self-update.ts
- status.ts
- uninstall.ts
- update-codex.ts
- validate-tweak.ts
- alerts.ts
- asar.ts
- cli-shim.ts
- cli.ts
- codesign.ts
- codex-window-services.ts
- fuses.ts
- integrity.ts
- logging.ts
- ownership.ts
- paths.ts
- platform.ts
- plist.ts
- self-update-state.ts
- source-root.ts
- state.ts
- update-mode.ts
- version.ts
- watcher.ts
- windows-cleanup.ts
- asar-cleanup.test.ts
- codesign.test.ts
- debug.test.ts
- install-preflight.test.ts
- ownership.test.ts
- platform.test.ts
- tweak-commands.test.ts
- uninstall.test.ts
- update-mode.test.ts
- windows-cleanup.test.ts
- LICENSE
- package.json
- README.md
- tsconfig.json
- loader.cjs
- package.json
- build.mjs
- codexpp_native_host.mm
- native-host.test.ts
- package.json
- README.md
- bundle-renderer.mjs
- copy-native-host.mjs
- index.ts
- manager.ts
- react-hook.ts
- settings-injector.ts
- tweak-host.ts
- browser-ui.ts
- codex-runtime-probe.ts
- logging.ts
- main.ts
- mcp-sync.ts
- native-bridge.ts
- native-paths.ts
- storage.ts
- tweak-discovery.ts
- tweak-lifecycle.ts
- tweak-store.ts
- watcher-health.ts
- logging.test.ts
- main-toggle-reload.test.ts
- mcp-sync.test.ts
- native-paths.test.ts
- storage.test.ts
- tweak-discovery.test.ts
- tweak-lifecycle.test.ts
- tweak-store.test.ts
- watcher-health.test.ts
- package.json
- tsconfig.json
- index.ts
- manifest-validation.test.ts
- package.json
- tsconfig.json
- auth-switcher.png
- better-browser.png
- better-terminal.png
- esc.png
- file-editor.png
- followup.png
- goal.png
- ios-simulator.png
- keyboard-shortcuts.png
- project-home.png
- quag.webp
- tab-switcher.png
- thought-fixer.png
- ui-improvements.png
- windows-computer-use.png
- index.json
- README.md
- AGENTS.md
- .gitignore
- CHANGELOG.md
- CONTRIBUTING.md
- install.ps1
- install.sh
- LICENSE
- package-lock.json
- package.json
- README.md
- SECURITY.md
- tsconfig.base.json
- update.ps1
- update.sh
# Installation Guide
node- Node.js >=16.0.0
- OpenAI Codex Desktop App
Setup Steps
npm install
Install project dependencies.
npm run build
Build the project.
node packages/installer/dist/cli.js install
Apply Codex++ patch and install the runtime.
Key Commands
npm run build
Compile source code and generate build artifacts.
npm test
Run the test suite.
codexplusplus install
Patch Codex and install the runtime.
codexplusplus status
Show installed version and patch state.
codexplusplus repair
Re-apply the patch after an app update or broken install.
codexplusplus safe-mode
Disable all tweaks without deleting them.
# Use via CDN
jsDelivrjsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.
Command Glossary
Commands referenced in this DOCs, explained below.
brew install
View Details ▼
brew install
Install a Homebrew formula or cask.
brew install {{formula|cask}}
Install a formula/cask:
brew install {{[-s|--build-from-source]}} {{formula}}
Build and install a formula from source (dependencies will still be installed from bottles):
brew install {{[-n|--dry-run]}} {{formula|cask}}
Download the manifest, print what would be installed but don't actually install anything:
bun install
View Details ▼
bun install
Install JavaScript dependencies for a project from `package.json`.
bun {{[i|install]}}
Install all dependencies listed in `package.json`:
bun {{[i|install]}} {{package_name}}@{{version}}
Install a single package (this is an alias for `bun add`):
bun {{[i|install]}} {{[-g|--global]}} {{package_name}}
Install a package globally:
node
View Details ▼
node
Server-side JavaScript platform (Node.js).
node {{path/to/file}}
Run a JavaScript file:
node
Start a REPL (interactive shell):
node --watch {{path/to/file}}
Execute the specified file restarting the process when an imported file is changed (requires Node.js version 18.11+):
npm run
View Details ▼
npm run
Run a script.
npm run
List available scripts:
npm run {{script_name}}
Run a script:
npm run {{script_name}} -- {{argument}} {{--option}}
Pass arguments to a script:
npm test
View Details ▼
npm test
This command is an alias of `npm run test`.
tldr npm run
View documentation for the original command: