Skip to main content
Brian Sunter
In development Status checked

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
JavaScript Stream Deck Codex
Cover image for Codex Stream Deck

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