codex-plugin

欢迎关注B站及YouTube频道：深度云创科技，感兴趣的朋友欢迎加入新时代智能体交流社群

客服微信：16773345788

A Codex skill that patches the local Codex desktop app so Fast/Speed mode and Plugins are available when Codex is signed in with an API key instead of ChatGPT OAuth. It can also optionally patch Codex remote SSH sessions so Zed appears as a remote-capable “Open With” target.

The main artifact is the installable skill package at skills/patch-codex-fast/SKILL.md. Install the repository through npx skills, then ask Codex to run patch-codex-fast. Codex should handle the doctor check, patch execution, verification, and rollback guidance for you.

When invoked, the skill guides Codex to:

1. Check the local Codex app path and required tools.
2. Back up the original app.asar.
3. Extract and patch the local Codex desktop bundle.
4. Re-sign the app on macOS.
5. Ask you to verify Fast/Speed mode, Plugins, and the Google Chrome row under Computer Use in API key mode.
6. Roll back immediately if Codex fails to launch.

You do not need to copy long patch commands manually. The scripts under the skill package are execution assets used by the skill.

Recommended install through npx skills:

npx skills add crazymsn/codex-plugin -g -a codex -y

This installs skills/patch-codex-fast/ as a global Codex skill. You can inspect the available skill before installing:

npx skills add crazymsn/codex-plugin --list

For the interactive cross-agent installer, run:

npx skills add crazymsn/codex-plugin

If you want to install the skill package path explicitly, use the GitHub tree URL:

npx skills add https://github.com/crazymsn/codex-plugin/tree/main/skills/patch-codex-fast -g -a codex -y

Manual install is still possible if you do not want to use npx skills:

git clone https://github.com/crazymsn/codex-plugin.git
mkdir -p ~/.codex/skills
ln -s "$(pwd)/patch-codex-fast/skills/patch-codex-fast" ~/.codex/skills/patch-codex-fast

Confirm the skill file exists:

ls ~/.codex/skills/patch-codex-fast/SKILL.md

In Codex, invoke the skill directly:

[$patch-codex-fast] Patch my local Codex app so Fast mode and Plugins work in API key mode.

Or describe the goal naturally:

Use patch-codex-fast to enable Fast mode and Plugins for my API-key Codex desktop setup.

The skill will run the appropriate local script for your OS. It should not ask you to perform the patch steps manually unless your environment blocks execution or the Codex bundle changed enough that manual inspection is required.

The skill is designed for this workflow:

1. Run doctor to inspect environment and app paths.
2. Run patch for the current OS.
3. Report the patch result and any warnings.
4. Ask you to completely quit and reopen Codex, then verify the UI including Google Chrome under Computer Use.
5. Run rollback if launch or verification fails.

Because this modifies an installed desktop application, Codex may warn before executing commands that stop Codex or write under the app installation directory.

• Codex desktop app installed.
• Node.js with npx.
• Python 3.
• macOS: codesign from Xcode Command Line Tools.
• Windows: PowerShell.

The patch uses npx @electron/asar and npx @electron/fuses. npx may download those packages on first run.

.
├── README.md
├── LICENSE
├── SECURITY.md
├── skills/patch-codex-fast/ # Canonical installable skill package
│   ├── SKILL.md             # Skill entrypoint used by npx skills and skills.sh
│   ├── scripts/             # Execution assets copied when the skill is installed
│   ├── README.md
│   ├── LICENSE
│   └── SECURITY.md
├── scripts/                 # Root development copy of implementation assets
│   ├── patch_codex_fast.py  # Cross-platform CLI
│   ├── codex_fast_patch/    # Python modules
│   ├── macos-patch.sh
│   ├── macos-rollback.sh
│   ├── windows-patch.ps1
│   └── windows-rollback.ps1
└── tests/
    ├── test_packaging.py
    └── test_patch_logic.py

This repository uses the conventional skills/<slug>/SKILL.md layout expected by the skills ecosystem:

skills/patch-codex-fast/SKILL.md

There is intentionally no root-level SKILL.md. The npx skills CLI checks a root SKILL.md first and returns it by default when present; keeping only the canonical skills/patch-codex-fast/ package prevents the root entry from shadowing the package path that skills.sh uses for the detail page and download snapshot.

The skills.sh page is expected at https://skills.sh/crazymsn/codex-plugin/patch-codex-fast. If the SKILL.md preview lags after a push, verify the GitHub source and CLI install first:

npx skills add crazymsn/codex-plugin --list
npx skills add crazymsn/codex-plugin -g -a codex --skill patch-codex-fast -y --copy

Direct script usage is mainly for debugging or for environments where you are not using Codex skills.

python3 scripts/patch_codex_fast.py doctor
python3 scripts/patch_codex_fast.py patch
python3 scripts/patch_codex_fast.py patch-zed-remote
python3 scripts/patch_codex_fast.py zed-remote-status

Rollback:

python3 scripts/patch_codex_fast.py rollback

python .\scripts\patch_codex_fast.py doctor
python .\scripts\patch_codex_fast.py patch
python .\scripts\patch_codex_fast.py patch-zed-remote
python .\scripts\patch_codex_fast.py zed-remote-status

Rollback:

python .\scripts\patch_codex_fast.py rollback

If Codex is installed somewhere else, pass both paths through the skill request or direct CLI options.

The patch changes local desktop bundle gates that currently depend on authMethod=chatgpt:

Optional Zed remote-open patch:

It also changes Electron fuses required for the unpacked modified app to load:

Codex updates can change bundle hashes and minified variable names. Re-run the skill first. If it reports that no patches were applied, the skill should inspect the extracted bundle and look for these targets:

grep -rl "authMethod" *.js | xargs grep -l "fast_mode"
grep -rl "pluginsDisabledTooltip" *.js
# Gate exported from gradient-*.js. Two known variants live in the wild:
#   older builds: function e(e){return e===`apikey`}
#   newer builds: function e(e){return e!==`chatgpt`}
# Both should be rewritten to `return false`.
grep -rlE 'return [A-Za-z_$]+(===|!==)`(apikey|chatgpt)`' *.js | grep -v locale
grep -rl "connector-unavailable" *.js | grep plugin

The same logical gates should be patched even if filenames or minified variables changed.

Use the skill rollback first:

[$patch-codex-fast] Roll back the Codex desktop patch.

If you must recover manually, close Codex and run the commands for your OS.

cd /Applications/Codex.app/Contents/Resources
[ -f app.asar.bak ] && cp app.asar.bak app.asar
[ ! -f app.asar ] && [ -f app.asar1 ] && cp app.asar1 app.asar
rm -rf app
npx @electron/fuses write --app /Applications/Codex.app OnlyLoadAppFromAsar=on
npx @electron/fuses write --app /Applications/Codex.app EnableEmbeddedAsarIntegrityValidation=on
npx @electron/fuses write --app /Applications/Codex.app EnableCookieEncryption=on
npx @electron/fuses write --app /Applications/Codex.app GrantFileProtocolExtraPrivileges=off
codesign --force --deep --sign - /Applications/Codex.app

Restore app.asar before deleting app/. If macOS reports Operation not permitted while writing inside the bundle, do not delete app/; grant App Management access or move /Applications/Codex.app aside, copy it back, then restore app.asar.

cd "$env:LOCALAPPDATA\Programs\Codex\resources"
Remove-Item -Recurse -Force app -ErrorAction SilentlyContinue
if (Test-Path app.asar1) { Rename-Item app.asar1 app.asar }
if (Test-Path app.asar.bak) { Copy-Item app.asar.bak app.asar }

Confirm that Codex can read the installed skill package:

ls ~/.codex/skills/patch-codex-fast/SKILL.md

For repository installs, the canonical source file is skills/patch-codex-fast/SKILL.md.

The installed Codex version likely changed the bundle patterns. Ask Codex to use this skill to inspect the extracted assets and update the target patterns.

If the Plugins UI is visible but the Computer Use Google Chrome row disappears after a restart, inspect these bundle surfaces:

grep -rl "chrome-internal" app/.vite/build
grep -rl "externalBrowserUseAllowed" app/.vite/build
grep -rl "isExternalBrowserUseAvailable" app/webview/assets

The current Chrome preservation patch maps the Dev runtime Chrome plugin name from chrome-internal to chrome, keeps the Chrome marketplace descriptor from being dropped by the external-browser feature gate, and prevents the renderer plugin list from hiding Chrome when isExternalBrowserUseAvailable is false.

For Zed remote-open support, inspect the main process open-target bundle:

grep -rl "id:\`zed\`" app/.vite/build
grep -rl "supportsSsh" app/.vite/build
grep -rl "vscode-remote://" app/.vite/build

The current Zed patch uses Zed’s documented Remote Development URL form, ssh://[user@]host[:port]/path. It prefers Codex’s structured SSH config (user/username, host/hostname/hostName, port) instead of the display alias so Zed does not accidentally try the local macOS username for a remote host. Line and column support for remote URLs still needs UI verification on a real SSH target; installing the Zed CLI on PATH improves line/column refinement after the app is opened.

Do not paste API keys, cookies, tokens, or proprietary bundle chunks into public issues.