Theme guide

Customize Your Codex Dream Skin Theme

Prepare a wide image, keep native text readable, and use the documented macOS studio to generate the theme assets.

View Original Project View Upstream Issues

Platform availability

The repository documents a user-image studio for macOS. The current Windows package uses bundled decorative assets and does not expose the same picker.

Prepare the image

Use PNG, JPEG, HEIC, TIFF, or WebP on macOS.
Keep the source at or below 50 MB; the prepared asset must remain at or below 16 MB.
A width of at least 2000px is recommended rather than enforced as a source minimum.
Favor a calm left side and enough tonal contrast for native headings.

Use the Finder picker

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

Omit flags to choose an image in Finder. The studio prepares the local asset and updates the theme configuration.

Use the macOS CLI

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh \
  --image "/path/to/image.png" \
  --name "My theme" \
  --accent "#7cff46" \
  --secondary "#36d7e8" \
  --highlight "#642a8c"

Reapply and check readability

Start or reapply Dream Skin after changing the image. Check the home and task routes, including the project picker and composer. If text contrast is weak, choose a quieter crop or adjust the accent colors.