Imported from xnydl/codex-dream-skin (
SKILL.md). Install upstream withnpx skills add xnydl/codex-dream-skin. Copyright stays with the author.
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
- Detect the OS before choosing scripts. Never mix platform directories.
- macOS: run
macos/Install Codex Dream Skin.command(ormacos/scripts/install-dream-skin-macos.sh), then use the Desktop launchers orswitch-theme-macos.sh --id preset-ssyai-dream. - Windows: run
windows/scripts/install-dream-skin.ps1, thenwindows/scripts/start-dream-skin.ps1. The tray controls apply/pause, background import, saved themes, and full restore. - Verify after launch with the platform verify script and inspect against the platform
references/qa-inventory.md. - 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.1only 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