explaingit

crazymsn/codex-plugin

19PythonAudience · developerComplexity · 3/5ActiveSetup · moderate

TLDR

Unofficial local patch shipped as a Codex skill that unlocks Fast mode, Plugins, and an optional Zed remote target in the Codex desktop app when users sign in with an API key.

Mindmap

mindmap
  root((codex-plugin))
    Inputs
      Codex install path
      User skill request
      Optional flags
    Outputs
      Patched app.asar
      Re-signed app
      Rollback on failure
    Use Cases
      Enable Fast mode
      Enable Plugins
      Add Zed remote target
      Run script standalone
    Tech Stack
      Python
      Node.js
      Electron asar
      Electron fuses
      codesign
      PowerShell

Things people build with this

USE CASE 1

Unlock Fast or Speed mode in the Codex desktop app when signed in with an API key

USE CASE 2

Make the Plugins sidebar appear without a ChatGPT OAuth login

USE CASE 3

Add Zed as a remote-capable target under the Codex Open With menu

USE CASE 4

Run the underlying Python patch script directly outside the Codex skill system

Tech stack

PythonNode.jsElectronnpx

Getting it running

Difficulty · moderate Time to first run · 30min

Modifies the installed Codex app and disables Electron integrity fuses; needs Node, Python 3, and codesign on macOS or PowerShell on Windows.

In plain English

codex-plugin is a small open-source project whose purpose is to unlock two features in the Codex desktop application for users who sign in with an API key rather than through a ChatGPT account. Those features are called Fast or Speed mode, and Plugins. Normally the Codex desktop app only shows them when you log in with ChatGPT OAuth, and this repository ships a local patch that flips the right gates so they appear in API-key mode as well. The patch can optionally also adjust Codex's remote-SSH settings so the Zed editor appears as a remote-capable target in the Open With menu. The README is upfront that this is an unofficial local patch. It modifies the installed Codex app on your own machine and turns off some Electron integrity fuses so the modified bundle can load. The project recommends only using it on machines where that tradeoff is acceptable. The main artifact is a Codex skill called patch-codex-fast. The recommended install path is to run a single command, npx skills add crazymsn/codex-plugin -g -a codex -y, which drops the skill into your global Codex skills folder. After that, inside Codex you ask for patch-codex-fast either by name or in plain English. The skill then walks Codex through a doctor check of paths and tools, backs up the original app.asar, extracts and patches the bundle, re-signs the app on macOS, asks you to restart Codex and verify that Fast mode, Plugins and the Google Chrome row under Computer Use are now visible, and triggers a rollback if launch or verification fails. Requirements include the Codex desktop app, Node with npx, Python 3, and platform-specific tools: codesign from Xcode on macOS, PowerShell on Windows. The patch itself uses two Electron utilities, @electron/asar and @electron/fuses, which npx may download the first time. Default install paths for both operating systems are documented, and command-line flags such as --resources-dir, --app-path, --no-stop and --zed-remote let you override locations or skip the stop-Codex step. The README also lists exactly what the patch changes. The fast auth gate, the fast hook early return, the fast model check, the plugins sidebar gate, the API-key detector and the connector availability check are all rewritten so that they no longer assume the user must be signed in with ChatGPT. The optional Zed patch adds supportsSsh: true to Codex's bundled Zed target so that Zed appears under remote Open With. Direct command-line use of the underlying Python script is also documented for people who would rather run the patch outside the Codex skill system. The project includes tests under tests/ and is laid out so that skills.sh can find the canonical skill package at skills/patch-codex-fast/.

Copy-paste prompts

Prompt 1
Install codex-plugin globally with npx skills add and run patch-codex-fast against my Codex install
Prompt 2
Walk me through the doctor check the skill performs before touching app.asar
Prompt 3
Use --resources-dir to point patch-codex-fast at a non-default Codex location on Windows
Prompt 4
Explain which Electron fuses get disabled and what risk that adds on macOS
Prompt 5
Roll back the patch and restore the original Codex app.asar from the backup
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.