How to install a Codex theme on macOS

What the current upstream supports

The macOS studio works with the official Codex Desktop app and states that it does not modify Codex.app, app.asar or the code signature. It discovers and validates the official app, launches Codex with a loopback-only Chromium DevTools Protocol endpoint and injects into expected app:// renderer targets.

Requirements

• macOS with the official Codex Desktop app installed.
• Codex launched at least once so ~/.codex/config.toml exists.
• A trusted local session. Do not run unknown local software while CDP is active.

Install from the original repository

Clone or download the repository from its GitHub page. From the macos directory, the upstream quick start currently documents:

./tests/run-tests.sh
./scripts/install-dream-skin-macos.sh --no-launch
~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh

The first command is an optional static check. The installer copies the engine to ~/.codex/codex-dream-skin-studio and creates visible Desktop launchers. Omitting customizer flags opens the Finder picker.

Apply a builder export

Replace the image placeholder with the absolute path to the WebP downloaded from this site. The macOS upstream currently documents these color arguments:

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh \
  --image "/absolute/path/to/theme.webp" \
  --name "My theme" \
  --accent "#B7FF4A" \
  --secondary "#50D9F5" \
  --highlight "#8573FF"

Verify before calling it done

1. Open Home and confirm that the title, suggestions and project selector remain clickable.
2. Open a normal task and test the sidebar, composer, menus and scrolling.
3. Open a Diff and check that added and removed lines remain legible.
4. Run the upstream Verify launcher or script and record the Codex and upstream versions.

Restore

Do not wait for a failure to learn rollback. Read the restore guide and confirm the launcher exists before applying the theme.