git404hub

what is streamdeck-dashboard fr?

christitustech/streamdeck-dashboard — explained in plain English

Analysis updated 2026-05-18

3JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

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.

vibe map

mindmap
  root((streamdeck-dashboard))
    What it does
      Shows Codex task status
      Updates once per second
      Amber green gray states
    Tech stack
      JavaScript
      Node.js
      OpenDeck
    Use cases
      Monitor Codex sessions
      Stream Deck status light
      Force manual refresh
    Audience
      Codex users
      Stream Deck owners

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

what do people make with this?

VIBE 1

See at a glance whether your local Codex coding sessions are still working or finished

VIBE 2

Get an always-visible Stream Deck indicator for background AI agent tasks

VIBE 3

Force an immediate status refresh by pressing the assigned Stream Deck key

VIBE 4

Monitor multiple simultaneous Codex sessions from one key

what's the stack?

JavaScriptNode.jsOpenDeckLinux

how it stacks up fr

christitustech/streamdeck-dashboardabhagsain/bayut-maps-ratingsabhishek-kumar09/who-is-imposter
Stars333
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-04-12
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity2/52/53/5
Audiencedevelopergeneralgeneral

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

how do i run it?

Difficulty · easy time til it works · 5min

Requires Linux, OpenDeck 2.13+, Node.js 18+, and a local Codex client already writing session logs.

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

in plain english

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.

prompts (copy fr)

prompt 1
Walk me through installing the Codex Status plugin into OpenDeck
prompt 2
Explain what process and file information this plugin reads to track Codex status
prompt 3
Help me build and package this plugin from source with npm
prompt 4
What Codex events does this plugin track, and what does it deliberately ignore?

Frequently asked questions

what is streamdeck-dashboard fr?

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.

What language is streamdeck-dashboard written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, OpenDeck.

What license does streamdeck-dashboard use?

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

How hard is streamdeck-dashboard to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is streamdeck-dashboard for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.