macOS installation

Install Codex Dream Skin on macOS

Use this independent guide to review the upstream macOS theme workflow for Apple Silicon and Intel Macs.

Get from Original Repository View Upstream Issues

Support and requirements

Apple Silicon or Intel Mac
The official Codex Desktop app installed and launched at least once
A local ~/.codex/config.toml
No separate global Node.js installation is required

Get the third-party tool

Open the macos directory in the original repository, review the source, and follow the upstream download instructions shown there. Avoid unofficial download mirrors.

Install Dream Skin

In Finder, double-click Install Codex Dream Skin.command. The source workflow below performs the same installation without launching immediately.

./scripts/install-dream-skin-macos.sh --no-launch

Start and customize

Use Codex Dream Skin.command to launch or reapply the theme. Use Codex Dream Skin - Customize.command to choose an image through Finder.

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh

Verify the result

Double-click Codex Dream Skin - Verify.command. Inspect both the home screen and a normal task so the native sidebar, project picker, composer, and task content remain usable.

~/.codex/codex-dream-skin-studio/scripts/doctor-macos.sh

Background image guidance

Supported source formats: PNG, JPEG, HEIC, TIFF, and WebP
Source file limit: 50 MB
Prepared file limit: 16 MB
A wide image at least 2000px across is recommended
Keep the left side relatively calm for native home titles

Restore Codex

Double-click Codex Dream Skin - Restore.command. Restore stops only the recorded injector and matching themed Codex session, then reopens the official app.

./scripts/restore-dream-skin-macos.sh