Install Guide

What is Codex Dream Skin?

Codex Dream Skin is an open-source tool that adds beautiful background themes to the Codex desktop app. It works via local CDP injection — no official binaries are modified.

• GitHub: Fei-Away/Codex-Dream-Skin
• License: MIT
• Platforms: macOS (Apple Silicon & Intel) and Windows

macOS Installation

1. Download or clone the repository
2. Open the macos/ folder
3. Double-click Install Codex Dream Skin.command
4. The tool installs to ~/.codex/codex-dream-skin-studio/
5. A menu bar icon appears — click it to manage themes

Switch theme via command line

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-gothic-void-crusade

Windows Installation

1. Download or clone the repository
2. Open PowerShell and run:

powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1

3. A system tray icon appears for theme management

Using a Downloaded Skin

1. Download a skin image from this site (2560x1440 JPEG)
2. Open the Dream Skin menu (menu bar on macOS, system tray on Windows)
3. Choose "Change Background" and select the downloaded image
4. The theme applies immediately — all Codex UI controls remain native

Restore Original Appearance

Click "Restore" in the menu bar / system tray at any time to return to the default Codex look.

Safety Notes

• CDP binds to 127.0.0.1 only — no network exposure
• No modification to .app, app.asar, or code signatures
• Does not change API keys or model provider settings
• Always verify after a Codex update; restore first if needed