Skip to content

mabyes1/codex-micro-windows-workaround

Repository files navigation

Codex Micro Windows Workaround

Temporary, non-destructive mitigation for severe Codex Desktop lag and repeated ChatGPT.exe crashes on Windows caused by the optional Work Louder / Codex Micro native module.

Warning

This is an unofficial community workaround, not an OpenAI fix. It temporarily disables Codex Micro hardware integration. Remove it after OpenAI ships a confirmed fixed build.

Symptoms

  • Codex Desktop freezes or makes system input lag when opening or switching tasks.
  • Windows Event Viewer records repeated Application Error event ID 1000 entries.
  • The exception code is 0xC06D007F.
  • Codex logs mention @worklouder/device-kit-oai and serialport.node.

Root cause

Affected Windows builds load the optional Codex Micro integration before confirming that the hardware exists. Its bundled serialport.node native addon tries to resolve Node-API symbols from ChatGPT.exe; those symbols are not exported by the packaged host. The load fails, and later UI activity retries it.

Related reports:

What this workaround does

The launcher sets NODE_OPTIONS=--require=<hook> only for the new Codex process. The preload hook intercepts exactly one CommonJS module:

@worklouder/device-kit-oai

It returns inert classes that report no supported device. The signed Store package, Codex authentication, sessions, projects, configuration, and global environment variables are not modified.

Install and run

  1. Download or clone this repository to a location outside %LOCALAPPDATA%.
  2. Fully quit Codex, including its system-tray process.
  3. Double-click Launch-Codex-Without-Micro.cmd.
  4. Use that launcher until OpenAI ships a confirmed fix.

The launcher currently allows only these known affected builds:

  • 26.707.9981.0
  • 26.707.12708.0

It refuses unknown versions so the workaround is not silently carried into a future fixed release.

Verify

After launching and using Codex for a few minutes, run:

Get-WinEvent -FilterHashtable @{
  LogName = 'Application'
  Id = 1000
  StartTime = (Get-Date).AddMinutes(-10)
} | Where-Object {
  $_.Message -match 'ChatGPT\.exe' -and
  $_.Message -match '0xc06d007f'
}

No matching new events should appear.

Limitations and security notes

  • Codex Micro / Work Louder hardware controls and RGB feedback are disabled.
  • Normal Codex agent, model, tools, browser, MCP, projects, and sessions remain available.
  • NODE_OPTIONS is a powerful Node.js mechanism. Review the small hook before running it.
  • Do not set this hook globally with setx NODE_OPTIONS.
  • Do not place the hook under %LOCALAPPDATA%; AppX path redirection can prevent it from loading.
  • Do not edit files under C:\Program Files\WindowsApps.
  • An OpenAI update may overwrite or fix the affected components. Re-test after every update.

Remove

Delete this folder and return to launching Codex normally. The workaround makes no persistent package or environment changes.

Acknowledgements

The preload approach was independently validated by contributors in openai/codex#33375 and openai/codex#33381. This repository packages that community mitigation with a version guard, documentation, and safer process-scoped launcher.

License

MIT. See LICENSE.

About

Temporary Windows workaround for Codex Micro serialport.node 0xC06D007F lag

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages