What Is Codex Dream Skin? A Complete Guide

What Codex Dream Skin actually is

The original Fei-Away/Codex-Dream-Skin project describes itself as an external theme tool for the desktop app. Its core promise is simple: keep the native sidebar, project selector, task cards, composer, keyboard focus, and other controls, then place a custom visual layer around them. That distinction matters. A useful theme should not replace the window with a flat screenshot or make the controls impossible to click.

On macOS, the project uses a local Chrome DevTools Protocol connection to inject CSS and a small renderer helper into the running desktop app. The repository states that it does not rewrite the signed application bundle, app.asar, or the official code signature. The Windows implementation uses its own platform scripts. Because these mechanisms depend on the current desktop app structure, an app update can still require a project update.

Before you install a custom skin

Start with the repository, not a re-uploaded script or a paid archive from an unknown seller. Review the latest README, open issues, and platform folder before running anything. A theme installer is local code with access to your machine, so the safest copy is the one you can inspect and compare with the public source.

• Confirm whether you are using the older Codex app or the new ChatGPT desktop app.
• Save current work and close sensitive tasks before changing launch behavior.
• Keep the project’s Verify and Restore commands available.
• Use an image you have permission to reuse, especially for public screenshots or paid themes.
• Expect to repeat verification after a desktop app update.

This site’s generator only prepares a theme pack in your browser. It does not connect to the desktop app, change launch settings, or run an installer. The separation is intentional: you can experiment with the visual direction first, then decide whether the current open-source installer is appropriate for your machine.

macOS

Install Codex Dream Skin on a Mac

1. 1

   Download the current repository

   Open the GitHub project and download or clone the latest source. Enter the macos folder instead of running scripts copied from a social post.

2. 2

   Run the installer

   Double-click Install Codex Dream Skin.command. macOS may ask you to confirm that you trust the local script. Read the prompt and the repository instructions before continuing.

3. 3

   Add your visual

   Use Customize Codex Dream Skin.command when it is available in the project version you downloaded. Choose an image, give the theme a clear name, and keep the original file in a stable location if the installer references it.

4. 4

   Launch and verify

   Start the themed app through the project’s launcher. Then run Verify Codex Dream Skin.command. Check that the sidebar, composer, task content, project selector, and keyboard focus still work.

The project’s safety notes say its CDP listener binds to 127.0.0.1. Even a loopback-only debugging port should be treated as a temporary local capability: do not run untrusted programs while the themed session is open, and close the themed app when you are finished.

Windows

Install Codex Dream Skin on Windows

Windows uses a different implementation and should not be treated as a copy of the Mac instructions. In the current repository layout, the documented flow starts with scripts/install-dream-skin.ps1 and then uses start-dream-skin.ps1 to launch the themed session.

1. 1

   Read the Windows guide

   Open the repository’s windows folder and read its SKILL or README file. Check supported app versions and PowerShell requirements.

2. 2

   Run the installation script

   Use PowerShell with the permissions described by the project. Do not permanently weaken your execution policy just to run a theme.

3. 3

   Launch through the provided script

   Use start-dream-skin.ps1 so the project can start the expected app process and attach its theme layer.

4. 4

   Check native controls

   Open a normal task, type in the composer, switch projects, and resize the window. A background that looks good but blocks interaction is not a successful installation.

How to verify the theme and restore the official appearance

A successful theme preserves the native product. Look for a visible sidebar, readable task content, a usable composer, no horizontal overflow, and decoration that never captures clicks. On the home route, the project also expects a real banner plus the native suggestion cards and project selector. Resize the window and test keyboard navigation instead of judging only one screenshot.

If anything is missing, distorted, or unresponsive, stop the themed session and use the project’s restore entry point. On macOS that is documented as Restore Codex Dream Skin.command. For Windows, follow the restore steps in the same repository version you installed. Restoring is also the sensible first move after an app update breaks selectors or changes the page structure.

Codex Dream Skin not working?

The background appears, but buttons do not work.

The decorative layer may be intercepting pointer events. Restore the official appearance, update to the latest project version, and verify that theme decoration uses pointer-events: none.

The theme disappeared after an app update.

The desktop app’s DOM or launch behavior probably changed. This is an adapter problem, not necessarily a problem with your image. Check the repository’s newest commits and issues before reinstalling.

The installer cannot find Codex.

You may now have the unified ChatGPT desktop app, a nonstandard install location, or both the classic and new apps. Use the project’s current platform guide to confirm the supported path.

Is this an official OpenAI feature?

No. Codex Dream Skin is a community open-source project, and this guide is an independent community resource. Neither is affiliated with or endorsed by OpenAI.

Continue with the path you need