whatisgithub

What is codex-dream-skin?

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

Analysis updated 2026-05-18

26ShellAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

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

Mindmap

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 build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

What is it built with?

ShellPowerShellNode.jsSwiftBarChrome DevTools Protocol

How does it compare?

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 you get it running?

Difficulty · easy Time to first run · 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.

So what is it?

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.

Copy-paste prompts

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?

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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.