gitwtfhub

wtf is codex-stream-deck?

emollick/codex-stream-deck — explained in plain English

Analysis updated 2026-05-18

29TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A Stream Deck plugin that turns physical buttons into a local dashboard for monitoring and controlling Codex AI coding tasks, with read only status checks.

Mindmap

mindmap
  root((codex-stream-deck))
    What it does
      Codex task dashboard
      Physical button control
    Tech stack
      TypeScript
      Stream Deck SDK
      Codex CLI
    Use cases
      Task status monitoring
      Quick task actions
    Audience
      Developers
      Codex users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor the status of recent Codex coding tasks directly from Stream Deck buttons.

REASON 2

Tap a button to jump straight into a specific Codex task without switching windows.

REASON 3

Trigger common Codex actions like new task, review, or interrupt from physical buttons.

REASON 4

Get passive status updates on Stream Deck while using Codex through its desktop app, CLI, or editor.

What's in the stack?

TypeScriptNode.jsStream Deck SDKCodex CLI

How it stacks up

emollick/codex-stream-deckdavidhdev/rbp-portfoliodrakkar-softwares/polymarket-kalshi-arbitrage-bot
Stars292929
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdesignerdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires an Elgato Stream Deck device and an already authenticated Codex CLI with app-server support.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Codex Control turns an Elgato Stream Deck, a physical panel of programmable buttons, into a small local dashboard for keeping track of tasks running in Codex, an AI coding assistant. Each button on the deck can represent a recent Codex task, showing its title, its current state such as working, waiting for input, needing approval, in review, done, or failed, and how long ago its status last changed. Tapping a button opens that exact task, while holding a button down asks Codex for a fresh status update without letting it write to any project files or reach the network. The project is an unofficial community plugin, not made or endorsed by OpenAI or Elgato. Beyond just showing task status, it adds buttons for common actions like refreshing, starting a new task, opening code, requesting a review, interrupting a running task, checking system health, and adjusting settings. Most people would install it from a packaged release file downloaded from the project's GitHub releases page, which Stream Deck can install directly, after which you arrange the provided buttons into a recommended fifteen key layout. Building it from source instead requires Node.js and an authenticated Codex command line tool with a specific server feature enabled. An optional feature lets the buttons update automatically even when Codex is used through other tools like its desktop app, command line, or code editor integration, by installing a small local bridge that only listens on your own machine and requires a security token to communicate with it. The README puts notable emphasis on security: the plugin does not require any API key of its own since it relies on your already logged in Codex session, it does not send data to any cloud service the developers run, status checks are read only with network access disabled, and all local processes are launched safely without using a shell. A separate security policy and audit document describe the project's threat model in more detail. It is released under the MIT license.

Yoink these prompts

Prompt 1
Walk me through installing the Codex Control Stream Deck plugin from a packaged release.
Prompt 2
Explain what the different task status labels like WORKING, REVIEW, and BLOCKED mean.
Prompt 3
How do I set up the optional passive notify bridge so buttons update automatically?
Prompt 4
What security measures does this plugin take since it can trigger actions on my Codex session?

Frequently asked questions

wtf is codex-stream-deck?

A Stream Deck plugin that turns physical buttons into a local dashboard for monitoring and controlling Codex AI coding tasks, with read only status checks.

What language is codex-stream-deck written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Stream Deck SDK.

What license does codex-stream-deck use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is codex-stream-deck to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-stream-deck for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.