Upstream instructions can change. Before running commands, compare this guide with the original GitHub repository.
Do not assume platform parity. The current Windows guide documents the bundled skin workflow, not a website-style arbitrary-image command. This site exports a wallpaper and recipe but does not claim that Windows consumes them directly.
Requirements
- Windows with the official Store-installed Codex app.
- Node.js 22 or newer.
- The original
Fei-Away/Codex-Dream-Skinrepository.
Install and launch
Close Codex. From the upstream windows directory, run the installer once and then use the launcher:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install-dream-skin.ps1 powershell -NoProfile -ExecutionPolicy Bypass -File scripts\start-dream-skin.ps1
The launcher asks before restarting an already open Codex app. Command-line callers must explicitly add -RestartExisting; do not hide that choice in automation.
Verify the live UI
powershell -NoProfile -File scripts\verify-dream-skin.ps1 -ScreenshotPath C:\absolute\path\verify.png
The upstream guide treats a missing hero, native composer, sidebar skin or injection marker as a failure. Inspect both Home and a normal Task; the suggestion count can change responsively.
Security boundaries
- Never replace or take ownership of files under
WindowsApps. - Keep decorative layers non-interactive and native controls above them.
- CDP stays on loopback, but it has no same-user authentication. Run only trusted local software.
- Preserve
config.tomlas strict UTF-8 and stop on ambiguous file shapes.
Restore before troubleshooting by hand
Use the documented restore script rather than deleting files or editing the app package. The restore guide explains the optional flags.