christitustech/streamdeck-dashboard — explained in plain English
Analysis updated 2026-05-18
See at a glance whether your local Codex coding sessions are still working or finished
Get an always-visible Stream Deck indicator for background AI agent tasks
Force an immediate status refresh by pressing the assigned Stream Deck key
Monitor multiple simultaneous Codex sessions from one key
| christitustech/streamdeck-dashboard | abhagsain/bayut-maps-ratings | abhishek-kumar09/who-is-imposter | |
|---|---|---|---|
| Stars | 3 | 3 | 3 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | — | 2021-04-12 |
| Maintenance | — | — | Dormant |
| Setup difficulty | easy | moderate | easy |
| Complexity | 2/5 | 2/5 | 3/5 |
| Audience | developer | general | general |
Figures from each repo's GitHub metadata at analysis time.
Requires Linux, OpenDeck 2.13+, Node.js 18+, and a local Codex client already writing session logs.
Streamdeck-dashboard is a small plugin for OpenDeck, an open source alternative to Elgato's Stream Deck software, that turns one physical key on a Stream Deck device into a live status light for OpenAI's Codex coding agent. The key shows one of three states: amber when at least one local Codex session is actively working on a task, green when Codex is running but everything it is watching has finished, and gray when no Codex process is running at all. The status updates automatically once a second, and pressing the key forces an immediate refresh. To use it, you need to be on Linux, have OpenDeck version 2.13 or newer installed, have Node.js 18 or newer on your machine, and be running a local Codex client that writes its session logs to the standard Codex folder on your computer. Installation is done by downloading the plugin file from the project's GitHub releases page and loading it into OpenDeck through its plugin settings, then dragging the Codex Status action onto whichever key you want to use. Behind the scenes, the plugin looks at running processes owned by your own user account to find any Codex sessions, then follows the log file each session is already writing to, watching only for two specific events: a task starting and a task finishing. It deliberately does not read your prompts, Codex's responses, credentials, environment variables, or any of your source code, and it has no network connection other than the local one OpenDeck itself requires between a plugin and the Stream Deck software. If several Codex sessions are running at once, the key stays amber and reports how many tasks are still active. This plugin is intentionally narrow in scope. It only tracks Codex processes running locally on Linux under your own user account, so it cannot see Codex tasks running in the cloud, sessions running as a different user, sessions on a different machine, or other AI coding agents entirely. The project is open source under the MIT license, written in JavaScript, and maintained by Chris Titus Tech, giving developers who already use Codex and a Stream Deck a simple always visible indicator of whether their agent is still working.
An OpenDeck plugin that turns a Stream Deck key into a live status light showing whether your local Codex sessions are working, done, or offline.
Mainly JavaScript. The stack also includes JavaScript, Node.js, OpenDeck.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.