How to Skin OpenAI Codex Desktop Client with the Free Codex‑Dream‑Skin Tool
This article introduces the open‑source Codex‑Dream‑Skin project that lets you replace the default white‑on‑black UI of the OpenAI Codex desktop client with custom backgrounds, colors, and layouts, explains its Electron‑based implementation, and provides step‑by‑step installation guides for both macOS and Windows.
The Codex‑Dream‑Skin repository on GitHub (⭐ 9 000) offers a free way to change the appearance of the OpenAI Codex desktop client by swapping its default white‑on‑black theme for any custom design.
Project Overview
Codex‑Dream‑Skin can replace the background image, color scheme, side bar, decorative elements, and output area without merely overlaying a static picture; the changes are applied directly to the client’s rendering process.
How It Works
Codex runs on Electron, which embeds a Chromium browser and exposes the Chrome DevTools Protocol (CDP). The tool launches a local CDP channel, injects custom CSS and DOM modifications into Codex’s renderer, and then closes the channel when the skin is disabled, leaving the original app untouched and fully signed.
Key steps on macOS include locating the com.openai.codex bundle, verifying its signature and architecture, starting Codex with a CDP port via launchd, and using the injector to push CSS/DOM changes. On Windows the process uses the AppUserModelId activation API, passes CDP parameters, bypasses ACL restrictions on the WindowsApps folder, and adds a tray icon for theme switching.
Installation – macOS
Clone the repository.
Open the macos/ folder in Finder and double‑click Install Codex Dream Skin.command.
Two preset themes ("Hashimoto Yuna" and "Gothic Sci‑Fi") are available; to use a personal image, drop it into the customizer, which automatically extracts a suitable color palette and safe‑area layout.
For quick switching, install the SwiftBar plugin and add the generated menu item.
Installation – Windows
Clone the repository.
Run the following PowerShell commands:
powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1The engine installs to %LOCALAPPDATA%\CodexDreamSkin\engine and a tray icon appears for theme management.
Use the tray menu to select a saved theme, import a custom background, or restore the original appearance with restore-dream-skin.ps1.
Safety Note
Because CDP provides full control over the renderer without authentication, the README warns users to avoid running untrusted local programs while the skin is active.
Reverting
On macOS, double‑click Restore Codex Dream Skin.command; on Windows, execute restore-dream-skin.ps1 to return Codex to its official look.
Signed-in readers can open the original source through BestHub's protected redirect.
This article has been distilled and summarized from source material, then republished for learning and reference. If you believe it infringes your rights, please contactand we will review it promptly.
IT Services Circle
Delivering cutting-edge internet insights and practical learning resources. We're a passionate and principled IT media platform.
How this landed with the community
Was this worth your time?
0 Comments
Thoughtful readers leave field notes, pushback, and hard-won operational detail here.