mpociot/codex-micro-stream-deck-emulator — explained in plain English
Analysis updated 2026-05-18
Use an existing Elgato Stream Deck to monitor and control ChatGPT Codex coding agent tasks.
Assign specific Codex tasks to Stream Deck keys and watch their status change color.
Adjust how deeply the coding agent reasons using the Stream Deck Plus dial.
Trigger approve, reject, split, or fast-mode actions directly from hardware keys.
| mpociot/codex-micro-stream-deck-emulator | brennanconroy/shootr | mkmukesh1319-ux/todo-list | |
|---|---|---|---|
| Stars | 33 | 33 | 33 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | 2022-04-10 | — |
| Maintenance | — | Dormant | — |
| Setup difficulty | moderate | hard | easy |
| Complexity | 3/5 | 3/5 | 1/5 |
| Audience | developer | developer | vibe coder |
Figures from each repo's GitHub metadata at analysis time.
Requires macOS, Node.js 18+, a physical Stream Deck, and the ChatGPT desktop app with Codex Micro support.
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.
Turns an Elgato Stream Deck into a Codex Micro macro pad for controlling and monitoring ChatGPT desktop coding agent tasks.
Mainly JavaScript. The stack also includes JavaScript, Node.js, macOS.
MIT licensed, meaning it can be reused freely with attribution, used at your own risk for personal interoperability purposes.
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.