Codex++ 0.1.2
Codex++ 0.1.2
Codex++ 0.1.2 is a resilience and tooling release. It fixes the Codex 26.429.20946 startup breakage, makes repair failures visible, and adds the first round of tweak developer tooling.
Highlights
- Fixed the Codex startup failure that could leave the app on
Codex failed to start. MwD is not definedafter Codex26.429.20946. - Reworked the macOS self-repair patcher around a fingerprint-based hook so minified Codex internals are less likely to break Codex++ on future updates.
- Added macOS repair-failure alerts with Dismiss and Report on GitHub actions.
- Added a Codex++ Config page health check for the auto-repair watcher, including a Check Now action.
- Fixed enable and disable behavior for
scope: "main"andscope: "both"tweaks so main-process state starts and stops immediately from Settings. - Added
create-tweak,dev,validate-tweak, andsafe-modecommands for local tweak development and recovery. - Added SDK manifest validation, permission metadata, and optional tweak-provided MCP server declarations.
- Added automatic Codex MCP config sync for enabled tweaks with
manifest.mcp. - Added CI coverage for tests and builds.
For Users
If Codex++ is already installed, update from the repo or your existing install path:
codexplusplus updateIf Codex is already stuck on a startup error, force a repair:
codexplusplus repair --forceRestart Codex after updating so the new runtime, Config page, watcher health check, and alert handling are loaded.
For Tweak Authors
This release adds the first dedicated tweak workflow commands:
codexplusplus create-tweak ./my-tweak
codexplusplus dev ./my-tweak
codexplusplus validate-tweak ./my-tweak
codexplusplus safe-modeTweak manifests can now declare permissions metadata and optional MCP servers. Enabled tweaks with manifest.mcp are synced into Codex's MCP config automatically.
Fixed
- Fixed update repair after Codex changed the minified window-services startup shape in
26.429.20946. - Fixed a malformed injected window-services expression that could produce
MwD is not defined. - Fixed launchd watcher registration so it uses the built CLI entrypoint instead of stale TypeScript source paths.
- Fixed main-process tweak enable/disable behavior from Settings.
Verification
Before cutting 0.1.2, the release branch passed:
npm test
npm run buildTest suite: 72 passing.