What is codex-windows-serialport-hotfix?

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.