mcpField
C
codex-dream-skin

codex-dream-skin

github.com/xnydlDesign & UI55133 installsUpdated 15w ago
Repository

About codex-dream-skin

A cross-platform skill for reversible full-window theming of the official Codex desktop app on macOS and Windows. It uses loopback Chromium DevTools Protocol and preserves the app package, signatures, and user state.

Key features

  1. 01Separate macOS and Windows engines
  2. 02Apply and switch themes
  3. 03Import and save themes
  4. 04Verify and restore appearance
  5. 05Preserve official app files and user state

Use cases

  1. 01Customizing Codex desktop appearance
  2. 02Switching between saved themes
  3. 03Restoring the default appearance
  4. 04Applying a wallpaper-based theme

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/xnydl/codex-dream-skin --skill codex-dream-skin

After installing, type/codex-dream-skinin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
LICENSE
README.md
NOTICE.md
agents/
openai.yaml
docs/
background-generation-prompts.md
reference-background-prompt-guide.md
platforms.md
macos/
.gitignore
CHANGELOG.md
CLIENT_DEPLOY_PROMPT.md
Install Codex Dream Skin.command
Restore Codex Dream Skin.command
LICENSE
Install Menu Bar.command
NOTICE.md
Customize Codex Dream Skin.command
README.md
Start Codex Dream Skin.command
VERSION
Verify Codex Dream Skin.command
package.json
macos/agents/
openai.yaml
macos/assets/
dream-skin.css
theme.json
renderer-inject.js
macos/menubar/
codex_dream_skin.10s.sh
macos/presets/
generate-presets.mjs
README.md
macos/presets/preset-midnight-aurora/
theme.json

Details

From the project README

Codex Dream Skin (cross-platform router)

Reversible full-window theming for the official Codex desktop app through loopback Chromium DevTools Protocol. Never modify the official .app, WindowsApps, app.asar, or code signatures.

This repository ships two self-contained platform engines. Detect the operating system first, then follow the platform skill:

  • macOS → macos/SKILL.md (Codex Dream Skin Studio: install, customize-from-image, menu bar, hot theme switch, verify, restore)
  • Windows → windows/SKILL.md (Store-app discovery, tray, theme repository, verify, restore)

Workflow

  1. Detect the OS before choosing scripts. Never mix platform directories.
  2. macOS: run macos/Install Codex Dream Skin.command (or macos/scripts/install-dream-skin-macos.sh), then use the Desktop launchers or switch-theme-macos.sh --id preset-ssyai-dream.
  3. Windows: run windows/scripts/install-dream-skin.ps1, then windows/scripts/start-dream-skin.ps1. The tray controls apply/pause, background import, saved themes, and full restore.
  4. Verify after launch with the platform verify script and inspect against the platform references/qa-inventory.md.
  5. Restore the official appearance with the platform restore entry point.

Guardrails (both platforms)

  • Preserve the official executable, package signature, user threads, pets, plugins, and authentication state.
  • Theme images must be UI-free wallpapers; never import an effect screenshot as a background.
  • Keep decorative layers pointer-events: none; native controls stay interactive above them.
  • Bind CDP to 127.0.0.1 only and treat the port as locally sensitive; prefer Restore when done.
  • Require explicit user authorization before restarting an already-running Codex instance.

Bundled default

The featured preset preset-ssyai-dream（世事宜梦境）is procedurally generated abstract art (2560 × 1440, no photos, no third-party IP). macOS seeds it into the theme library; Windows seeds it as the active theme and a saved theme.

Provided free by 世事宜AI: https://ssyai.xytpark.cn/purchase

Comments

Markdown supported