88gravessong/codex-windows-serialport-hotfix — explained in plain English
Analysis updated 2026-05-18
Fix the serialport.node crash in the exact affected build of OpenAI Codex on Windows.
Run a read-only diagnostic script to confirm whether an installed Codex build is affected before patching.
Launch a patched, isolated copy of Codex from a desktop shortcut while keeping the official install untouched.
Uninstall the hotfix later without affecting user data or the original installation.
| 88gravessong/codex-windows-serialport-hotfix | deathcats4/scholar-ppt-cn | mrwynn/codex-proxy-launcher | |
|---|---|---|---|
| Stars | 16 | 15 | 15 |
| Language | PowerShell | PowerShell | PowerShell |
| Setup difficulty | moderate | easy | easy |
| Complexity | 3/5 | 2/5 | 2/5 |
| Audience | developer | researcher | developer |
Figures from each repo's GitHub metadata at analysis time.
Only works on the exact affected version, OpenAI.Codex 26.707.9981.0, and requires PowerShell 7 or newer.
This project is an unofficial fix for a specific crash bug in one particular Windows build of the OpenAI Codex desktop app, version 26.707.9981.0. The affected build bundles an older native module called serialport.node, originally meant for a hardware-related Codex Micro feature, that tries to import a function the current Electron runtime does not provide. That mismatch causes the app to crash with a specific Windows error. Rather than touching the official installed app, the included PowerShell script copies the official app into a separate folder under the user's local app data, disables the Codex Micro feature in both the interface and the background service inside that copy, and then launches the copy using the same user profile and data as the original. The official installation itself is never modified. The script is strictly locked to the one affected version number and refuses to run against any other version, since a different build would need its own patch and its own verification. The author documents specific before-and-after test results on a reproduction machine, showing the unpatched app crashing after about eleven seconds while the patched copy ran over a minute without errors or crash dumps. The repository is meant to be used by someone who already has a legitimate, official installation of the affected Codex build and wants a working temporary fix rather than waiting for OpenAI to ship one. It does not require administrator rights, does not take ownership of protected system folders, does not modify the official package, and does not send any data over the network. It also includes documentation aimed at AI coding agents, so an agent can read a short handoff file and run read-only diagnostic checks before applying anything. The code is released under the MIT license.
An unofficial PowerShell hotfix that patches a specific crash in one Windows build of the OpenAI Codex desktop app without touching the official install.
Mainly PowerShell. The stack also includes PowerShell, Electron, Windows.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.