Interactive by design
Project picker, suggestion cards, task content, sidebar, menus, and composer remain real Codex controls.
Codex Dream Skin · Open source
Codex Dream Skin for macOS & Windows.
Install immersive themes for Codex Desktop without modifying the official app. Keep native controls, use your own artwork, and restore the original appearance anytime.
macOSWindowsReversibleNo app patching
Real native controlsNot a screenshot overlay
Quick answer
What is Codex Dream Skin?
Codex Dream Skin is a free, unofficial theme system for Codex Desktop on macOS and Windows. It applies immersive backgrounds and visual styling through a local CDP session without changing the official app bundle or code signature.
Last updated: July 16, 2026 · Source checked against the upstream repository
Local onlyCDP binds to 127.0.0.1
Native UISidebar and composer stay live
One-click restoreReturn to the stock appearance
Your imagePersonalize the theme on macOS
Codex skin gallery
Three focused theme previews.
A focused set of upstream previews without recognizable real people or named third-party characters. Use only artwork you own or have permission to use.
Built differently
Atmosphere without losing the app.
Swap the artwork
Use a wide image to create a home banner, quiet task background, accent palette, and frosted content layers.
Safe rollback path
Restore stops the injector and reopens Codex normally. The official application bundle remains untouched.
Platform comparison
Choose the right Codex theme mode.
Native colors are simplest. Dream Skin adds background artwork and richer visual layers, with different capabilities on each platform.
| Capability | Native Codex theme | Dream Skin on macOS | Dream Skin on Windows |
|---|---|---|---|
| Background image | No | Yes | Included theme assets |
| Custom image picker | No | Yes | Not yet at macOS parity |
| Extra runtime | None | Uses validated bundled Node | Node.js 22+ |
| Restore path | Change Settings | Restore launcher | Restore PowerShell script |
| Best for | Simple color changes | Personal immersive skins | Ready-made immersive skins |
Quick start
Choose your platform.
Start from the original repository so you always get the latest scripts and safety fixes.
macOS
Apple Silicon & Intel
Install, choose your own image, verify the theme, and restore from desktop launchers.
- Download or clone the repository
- Open the
macosfolder - Run
Install Codex Dream Skin.command
Windows
Codex from Microsoft Store
Install the skin scripts, launch the themed session, verify it, and restore when needed.
- Install Node.js 22 or newer
- Run
install-dream-skin.ps1 - Launch with
start-dream-skin.ps1
Know the boundary
Local, reversible, and unofficial.
The theme uses Chromium DevTools Protocol on your computer. CDP is powerful and has no same-user authentication, so only run trusted local software while a themed session is active.
It does not modify .app, app.asar, WindowsApps, your API key, or your model provider settings.
Primary sources
Verify before you install.
FAQ
Before you install.
What is Codex Dream Skin?
Codex Dream Skin is an unofficial open-source theme layer for Codex Desktop. It uses a local CDP connection to apply backgrounds, colors and decorative layers while keeping native Codex controls interactive.
Is Codex Dream Skin free?
Yes. The source code is available on GitHub under the MIT license. Always download it from the original repository and review the latest instructions before installing.
Is CodexSkin an official OpenAI product?
No. CodexSkin is an independent community website for the open-source Codex Dream Skin project. Codex and OpenAI trademarks belong to their respective owners.
Does it modify the Codex app or app.asar?
No. The project launches the official Codex Desktop app with a local-loopback CDP connection and injects the visual theme at runtime. It does not patch the official app bundle, WindowsApps files, or code signature.
Can I restore the original Codex appearance?
Yes. Both macOS and Windows include a restore flow. The project is designed to be reversible.
Which platforms are supported?
The current open-source project supports Apple Silicon and Intel Macs, plus Windows. Custom image selection is currently available on macOS.
Do I need Node.js?
Windows requires Node.js 22 or newer. The macOS workflow validates and uses the Node runtime bundled with the signed Codex app, so a separate global Node.js installation is not required.
Theme builder · Coming soon