jiarong0423/codex-dream-skin-workflow-engine — explained in plain English
Analysis updated 2026-05-18
Customize the visual theme of the Codex desktop app without modifying the official application.
Build and test a reversible custom theme for a native macOS Electron-style app.
Study a working example of safe, non-destructive DevTools Protocol based UI injection.
| jiarong0423/codex-dream-skin-workflow-engine | anil-matcha/open-ai-vibe-coding-course | arthurmoorgan/drift | |
|---|---|---|---|
| Stars | 6 | 6 | 6 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | 2026-06-30 | — |
| Maintenance | — | Active | — |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 1/5 | 2/5 |
| Audience | developer | pm founder | general |
Figures from each repo's GitHub metadata at analysis time.
macOS only, requires the official Codex desktop app already installed.
Codex Dream Skin Workflow Engine is a local desktop theming tool for the macOS version of OpenAI's Codex app. It changes the visual appearance of the official Codex desktop application by injecting CSS styles and small DOM markers into the app's interface through Chrome's DevTools Protocol, connecting only to 127.0.0.1 on the local machine. It does not modify the official application files, its code signature, or any user login data. Rather than being a single fixed skin, the project is a full workflow: visual ideas are turned into a structured theme specification, image assets are processed and compressed, the theme is applied to specific named modules of the interface, the result is checked against the app's native layout so nothing important is covered or broken, and the whole theme can be fully reverted at any time. Users do not need a ready made prompt to start, they can begin from a rough idea and refine it interactively with Codex itself. The project targets specific named surfaces in the app, such as the sidebar, the message composer, chat bubbles, and side panels, and treats them differently from independent decorative elements like character graphics, which must stay clear of anything a user needs to read or click. A small set of interactive elements, like a click triggered animation, only load their assets when actually activated and clean up afterward, which keeps the tool from running background processes all the time. Technically, the project is built from a Node.js and Bash based command line installer, a JSON theme specification file, a JSON module policy file controlling which visual pieces load and when, a plain CSS stylesheet for the visual layer, and a JavaScript file that injects and manages the DOM markers safely and repeatedly. Image assets are shipped as PNG, WebP, SVG, sprite sheets, and GIF fallbacks. The project explicitly avoids reading or changing the app's authentication file, modifying its packaged application bundle, or altering API key or model provider settings, and it only ever connects to the local machine. It was built for the OpenAI Build Week 2026 competition in the Developer Tools track.
A local macOS tool that safely re-skins the OpenAI Codex desktop app's interface via DevTools Protocol injection, without patching the official app.
Mainly JavaScript. The stack also includes Node.js, Bash, CSS.
No license information was found in the material provided.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.