y5862000/threaddeck-for-codex

ThreadDeck for Codex turns an Elgato Stream Deck, a small physical device with programmable buttons, into a hardware dashboard for Codex, OpenAI's coding assistant desktop app. Instead of switching between windows and clicking through menus on your Mac, you press physical keys to monitor and control your active Codex tasks. Each key on the Stream Deck can show a live task card with details like the task's title, whether it is pinned, how many items are queued, and how intensively the AI is reasoning about the task. You can press a key to jump straight to a specific task, whether it is running locally or on a remote machine, without touching the mouse. Holding down a task key starts voice dictation, letting you speak a follow up message that gets automatically transcribed and submitted, while a dedicated microphone key works the same way for a new message. Other keys let you change how much reasoning effort the AI puts into a task, toggle a faster response mode, start new tasks, and get visual feedback pulses when a task finishes. Under the hood, the plugin primarily uses Codex's own internal renderer and command system when available, since this is more reliable, but it falls back to macOS keyboard shortcuts and accessibility features if that internal connection is not present. It reads local Codex data but never writes to Codex's own files, and everything runs locally on your Mac rather than through any external server. To use it you need a Mac running macOS 13 or later, a Stream Deck Neo device, and the Codex Desktop app installed. Setup involves downloading a plugin file, installing it, and granting Stream Deck accessibility permission in macOS system settings. The documentation and interface are available in both English and Korean. The project is open source under the MIT license.