git404hub

what is codex-dream-skin fr?

roland-luo/codex-dream-skin — explained in plain English

Analysis updated 2026-05-18

26ShellAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

An unofficial theming tool that restyles the Codex desktop app's appearance without modifying its official files or functionality.

vibe map

mindmap
  root((codex-dream-skin))
    What it does
      Restyles Codex appearance
      Keeps functionality intact
      Reversible at any time
    Platforms
      macOS full support
      Windows experimental
    Tech stack
      Shell scripts
      Chrome DevTools Protocol
      SwiftBar menu bar
    Themes
      Five built in themes
      Custom image themes
      Auto rotation
    Audience
      Non technical users
      Codex desktop users

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

Change the visual theme of the Codex desktop app using a built in preset or a custom photo.

VIBE 2

Switch between multiple saved themes from a menu bar app or automatically on a timer.

VIBE 3

Restore Codex to its original official appearance at any time with one script.

what's the stack?

ShellPowerShellNode.jsSwiftBarChrome DevTools Protocol

how it stacks up fr

roland-luo/codex-dream-skinbeerandcodeteam/beer-and-code-harnessecho-of-machines/fable-advisor
Stars262626
LanguageShellShellShell
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneraldeveloperdeveloper

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

how do i run it?

Difficulty · easy time til it works · 5min

Requires the official Codex desktop app to already be installed and opened at least once.

MIT License, free to use, modify, and share as long as the copyright notice is kept.

in plain english

Codex Dream Skin is an unofficial tool that lets someone change how the Codex desktop app looks, without touching the official application files or code signing. It restyles the home screen, sidebar, suggestion cards, and input area with a chosen theme, while every button and text field keeps working exactly as before. Users can pick from five built in themes or generate a new one from their own image, and can switch back to the official look at any time. The main supported platform is macOS, on both Apple silicon and Intel machines, and it is aimed at people with no coding background. After opening the official Codex app at least once, a person just double clicks a command file in the macos folder, picks an image in the window that appears, types a theme name, and waits for Codex to relaunch with the new look applied. The install process also drops several ready made shortcuts on the desktop for everyday launching, generating a new theme from a new image, tweaking the current theme, verifying the install, and restoring the original appearance. A menu bar switcher, built on the SwiftBar project, is also available so someone can flip between the five built in themes or turn on automatic theme rotation every 30 minutes. Windows support exists but is described as experimental, since the author has no Windows machine to test it against, and it currently cannot generate a theme from a custom image. It needs Node.js installed and uses PowerShell scripts to install, start, and restore the app. Under the hood, the theme is applied by connecting to the official Codex app through the Chromium DevTools Protocol, listening only on the local loopback address. The README states it does not modify the official app package, does not touch API keys or model provider settings, and only adjusts appearance related configuration that can be fully restored. The project is released under the MIT License and is not affiliated with OpenAI.

prompts (copy fr)

prompt 1
Walk me through installing Codex Dream Skin on macOS step by step for a non technical user.
prompt 2
Explain how this tool changes Codex's appearance without modifying the official app files.
prompt 3
Help me pick a good image to turn into a custom theme based on this repo's image guidelines.
prompt 4
What does the Chrome DevTools Protocol based safety approach in this repo actually restrict?

Frequently asked questions

what is codex-dream-skin fr?

An unofficial theming tool that restyles the Codex desktop app's appearance without modifying its official files or functionality.

What language is codex-dream-skin written in?

Mainly Shell. The stack also includes Shell, PowerShell, Node.js.

What license does codex-dream-skin use?

MIT License, free to use, modify, and share as long as the copyright notice is kept.

How hard is codex-dream-skin to set up?

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

Who is codex-dream-skin for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.