Codex Themes

Windows · manual and Codex-assisted paths

Install Codex Dream Skin on Windows

Clone the official repository, install the managed runtime, then launch from PowerShell or the created shortcut. Bundled themes are available from the system tray. Verification is optional; restoration is always available.

Official repository

Before you start

Confirm the local prerequisites

  • Official Codex Desktop installed and launched at least once
  • Node.js 22 or newer
  • PowerShell
RecommendedUse Codex to install

Copy a safety-scoped Windows prompt

The prompt uses the official repository, protects unrelated configuration, makes verification optional, and requires a restore handoff.

Review the full prompt before copying
Help me install Codex Dream Skin from the official repository https://github.com/Fei-Away/Codex-Dream-Skin.

No specific theme was selected. After installation, show me the bundled themes and ask before applying one.

Safety requirements:
- Explain each action before running it.
- Use only the official repository scripts and current repository documentation. Do not modify the official app bundle, app.asar, WindowsApps, code signatures, or system security settings.
- Do not read, print, replace, or upload API keys, Base URLs, authentication data, private project paths, images, or unrelated configuration.
- If config.toml is complex or multiline, changes during the operation, or a script refuses it, stop and explain. Never delete or rebuild it.
- If a command no longer matches the current repository documentation, stop and report the mismatch instead of improvising.
- Verification is optional, but offer it after launch and explain what evidence it creates.
- Finish by giving me the exact restore command and log/state location.

Windows workflow:
1. Confirm this is Windows and read README.md, windows/SKILL.md, and the relevant PowerShell scripts.
2. Confirm official Codex Desktop has launched at least once, PowerShell is available, and Node.js 22 or newer is installed.
3. Clone the repository using:
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
Set-Location Codex-Dream-Skin
4. Install using:
powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
5. Start using:
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1
6. Use the system tray to show the bundled presets and ask which one to apply.
7. Offer the optional verification command and ask for an absolute screenshot path only if I want evidence:
.\scripts\verify-dream-skin.ps1
8. Explain state/log path %LOCALAPPDATA%\CodexDreamSkin and restore with:
.\scripts\restore-dream-skin.ps1
Read every proposed action in Codex before approving it.

Alternative · Manual PowerShell path

Five clear steps from clone to restore

Run the commands from a normal PowerShell session. After installation, shortcuts use the managed engine under your local application data and no longer depend on the source checkout.

Clone the official repository

Clone the official GitHub project and enter the repository. The PowerShell commands below include the Windows script path.

Windows

Clone the engine source

Use the official project URL and keep the checkout available until installation finishes.

git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
Set-Location Codex-Dream-Skin
Run only after reading the platform guide.

Install the managed runtime

The installer preserves the native appearance baseline, copies the runtime to %LOCALAPPDATA%\CodexDreamSkin\engine, and creates launch, restore, and tray shortcuts that do not depend on the checkout.

Windows

Run the install script

Run from the cloned repository root. The command uses the Windows installer in the local checkout.

powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
Run only after reading the platform guide.

Start and switch themes

Start Dream Skin through the repository script or the created Codex Dream Skin shortcut. The system tray supports apply, pause, import, save, switch, and restore. The first launch preloads the same bundled preset collection used on macOS.

Windows

Start Dream Skin

The launcher uses local CDP and dynamically locates the registered official Codex package.

powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1
Run only after reading the platform guide.

Bundled themes in the tray

  • Romantic Rose
  • Cyber Neon
  • Forest Mist
  • Midnight Aurora
  • Amber Dusk
  • Sakura Dawn
Native sidebar, composer, and project controls should remain interactive.
Import only UI-free backgrounds; the tray copies accepted files into the managed local theme store.

Verify and retain evidence

Optional

Verification is not required to keep using Dream Skin. Run it when you want to check the home shell, native controls, task view, and injection marker. Add an absolute screenshot path only when you want retained evidence.

Windows

Optional

Optional verification

Review screenshots and remove sensitive content before sharing. Never assume a username or personal path.

.\scripts\verify-dream-skin.ps1
Optional: use this when you want retained verification evidence.

Restore the original appearance

Run the base restore to remove the live skin and close the saved CDP session. Use optional switches only for their documented purpose: -RestoreBaseTheme restores saved appearance keys, -RecoverConfigBackup performs explicit byte-for-byte recovery, and -Uninstall removes shortcuts.

Windows

Restore Dream Skin

Keep this command available before you start installation.

.\scripts\restore-dream-skin.ps1
Run only after reading the platform guide.

Windows paths and runtime notes

State, logs, themes, and engine

%LOCALAPPDATA%\CodexDreamSkin

Local CDP port

Default 9335. The launcher scans for a free port when the default is occupied; an explicitly requested occupied port fails closed.

TroubleshootingReview the safety boundary