Agent skill · software engineering · aradotso
codex-plusplus-tweak-system
Expert knowledge for using codex-plusplus to inject tweaks, patch Codex desktop app, and write custom ESM tweak modules with lifecycle APIs.
Why this skill is useful
Adds executable scripts and detailed procedures for patching and extending the Codex desktop app with custom tweaks that are not publicly documented.
What it needs
Requires codexplusplus installed locally. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
codex-plusplus Tweak System Skill by ara.so — Daily 2026 Skills collection. codex-plusplus is a tweak injection system for the Codex desktop app (Electron-based). It patches app.asar, injects a loader stub, and runs a hot-reloadable runtime from the user directory. Tweaks are small ESM modules with a manifest and start/stop lifecycle — no app rebuild required. --- Installation Homebrew (macOS, recommended) Bun (global) Source bootstrap (macOS / Linux) Windows PowerShell The installer: 1. Locates Codex.app (or Windows equivalent) 2. Backs up the original to ~/.codex-plusplus/backup/ 3. Patches app.asar to require the loader 4. Recomputes asar header SHA-256, writes it into Info.plist 5. Flips EnableEmbeddedAsarIntegrityValidation in the Electron Framework binary 6. Re-signs ad-hoc on macOS (codesign --force --deep --sign -) 7. Installs a launch agent / login item for auto-repair on Codex updates 8. Installs default tweaks unless --no-default-tweaks is passed --- Key CLI Commands --- File Locations Artifact Path --- --- Loader stub Codex.app/Contents/Resources/app.asar Runtime <user-data-dir>/runtime/ Tweaks <user-data-dir>/tweaks/ Config <user-data-dir>/config.json Backup <user-data-dir>/backup/ <user-data-dir> per OS: macOS: ~/Library/Application Support/codex-plusplus/ Linux: $XDGDATAHOME/codex-plusplus/ (default ~/.local/share/codex-plusplus/) Windows: %APPDATA%/codex-plusplus/ --- Writing a Tweak Folder Structure manifest.json Required fields: id (reverse-domain), name, version, githubRepo (for update checks), author, description, minRuntime. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/codex-plusplus-tweak-system