Codex Dream Skin: Give Your Codex Desktop a Breathing Face
A deep dive into Codex Dream Skin, an open-source theming tool for Codex Desktop that uses local CDP injection to apply custom backgrounds without modifying official binaries.
Codex Dream Skin: Give Your Codex Desktop a Breathing Face
If you spend hours in Codex Desktop every day, you know the default UI can feel a bit sterile. Codex Dream Skin is an open-source theming tool that lets you swap in custom backgrounds, save themes, and switch between them — all without touching the official .app, app.asar, or WindowsApps.
What It Does
Codex Dream Skin injects a pure background layer into the Codex window using local loopback Chrome DevTools Protocol (CDP). The result is a fully interactive UI: sidebars, suggestion cards, project selectors, and input fields remain native and clickable. It's not a static screenshot overlay.
Key capabilities:
- Real background layer: A 16:9 wallpaper spans the entire window, with reduced interference on task pages.
- Swappable images: Replace the background with any image; the tool adapts focus, safe zones, and color schemes.
- Theme saving: macOS menu bar and Windows system tray let you save and switch local themes.
- One-click restore: Revert to the official appearance instantly.
- Safe injection: Uses local loopback CDP; does not modify official binaries or signatures.
Quick Start
The repository provides platform-specific scripts:
macOS
# Install (double-click Install Codex Dream Skin.command or run:)
cd macos
./scripts/install-dream-skin-macos.sh --no-launch
# Switch to a preset theme
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
--id preset-gothic-void-crusade
Windows
# Install
powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
# Start
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1
After starting, you can switch themes directly from the system tray under "Saved Themes."
Preset Themes
Gothic Void Crusade
A community-contributed sci-fi theme by @seansong-ideogram. It's the default on fresh macOS installs.
Arina Hashimoto
A verified theme tested on both light and dark Codex appearances. The source PNG is 1672×941; the preset exports a derived 2560×1440 JPEG.
Concept Galleries
The repository includes eight concept images that demonstrate possible visual directions. These are not directly importable as backgrounds — they include UI overlays. To create similar effects, generate a clean 2560×1440 image using the provided prompt templates.
Security Boundaries
- CDP binds only to
127.0.0.1. Do not run untrusted local programs while the theme is active. - Does not modify official installation directories or code signatures.
- Does not automatically rewrite API keys or base URLs; theming and API configuration remain independent.
License and Disclaimer
- Licensed under MIT (see
macos/LICENSEandmacos/NOTICE.md). - Not an official OpenAI product. Codex and related rights belong to their respective owners.
- Preset images and character/IP materials are for theme illustration only. Verify rights before commercial redistribution.
Why This Matters
For developers who live in Codex, a personalized environment can boost focus and enjoyment. Codex Dream Skin delivers that without compromising security or requiring deep system modifications. With 11.1k stars and 1.1k forks, it's clearly resonating with the community.
Star the repo, pick an image, and make your Codex look the way you feel today.