mpociot/codex-micro-stream-deck-emulator

This project lets an Elgato Stream Deck act as a Codex Micro, a specific macro pad device made for the ChatGPT desktop app that shows the status of coding agent tasks and offers controls for them. Instead of buying that dedicated hardware, this tool makes the ChatGPT app treat an existing Stream Deck as if it were the real device. The project has two moving parts. A bridge process runs in the background and talks directly to the connected Stream Deck. A small shim script relaunches the ChatGPT desktop app so that it detects the virtual Codex Micro device. Once both are running, the Stream Deck's buttons light up to reflect the status of your Codex tasks, action buttons trigger commands like approving or rejecting a task, and if you have a Stream Deck Plus, its rotating dial controls how deeply the coding agent reasons through a problem, with a second dial for push to talk and a third for submitting. The top row of keys can be configured to follow specific coding tasks automatically, based on recency, priority, or pinned status, or you can assign tasks to keys manually. Each key changes color depending on the task's state: white for idle, blue while thinking, green when complete, amber when it needs input, and pink on error. The bottom row holds fixed action buttons, and colors and icons can be customized by editing a few source files. Setup requires macOS, Node.js version 18 or higher, an actual Stream Deck, and the ChatGPT desktop app with Codex Micro support. The README is explicit that the project ships none of OpenAI's, Work Louder's, or Elgato's code or assets, and instead reimplements the communication protocol independently using open licensed icons, describing itself as an interoperability tool for people who already own the hardware, released under the MIT license and intended for personal use at your own risk.