--- title: "Codex Stream Deck" description: "An importable Stream Deck XL profile and bundled status plugin for the local Codex desktop app, generated from a Node.js build script." url: "https://briansunter.com/projects/codex-stream-deck" --- Jul 19, 2026 In development Status checked Sep 15, 2026 # Codex Stream Deck An importable Stream Deck XL profile and bundled status plugin for the local Codex desktop app, generated from a Node.js build script. [View Source](https://github.com/briansunter/codex-stream-deck) JavaScript Stream Deck Codex  ## Overview Codex Stream Deck is an importable Stream Deck XL profile for the local Codex app, plus a bundled `Codex Status` plugin that surfaces live task state. Every key uses a custom 144px PNG with the action word baked into the artwork, so Stream Deck’s native (and easily clipped) titles are disabled. The profile is generated by `build-profile.mjs`, so it can be rebuilt when the app bundle id or device path changes. ## Features - Codex Micro-inspired workflow row: `REVIEW`, `DEBUG`, `REFACTOR`, `TEST`, `PLAN`, `SHIP`, `AGENTS`: each opens a new Codex task with a focused prompt - `OPEN`, `LAUNCH`, `HERE`, and workflow keys use the `codex://` deep-link protocol instead of simulated keystrokes - Context-sensitive `Approve`/`Reject` keys mapped to Codex approval shortcuts - Live `STATUS` key via the bundled plugin: amber (running), green (done), orange (stopped), red (error) - Validates Codex desktop shortcuts against the installed app on every build - Targets a configurable workspace via `CODEX_WORKSPACE` ## Technology Stack - Stream Deck XL profile + Stream Deck SDK (WebSocket) - Node.js build script (`build-profile.mjs`) - `codex://` deep-link protocol - JavaScript plugin (`com.briansunter.codex-status.sdPlugin`) ## Availability The repository provides the profile, plugin source, and build script, but no public packaged release or marketplace listing was verified during this audit. ## Share this project