codex-dream-skin

name codex-dream-skin description Install, customize, switch, verify, or restore a full adaptive theme for the Codex desktop app on macOS or Windows. Use when the user wants a Codex theme beyond official color settings, wants to turn a personal image into a full-window Codex wallpaper with adaptive readability, needs the skin reapplied after a Codex update, wants to switch saved themes from the menu bar or tray, or needs a safe rollback without modifying the official app or app.asar. 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 (or macos/scripts/install-dream-skin-macos.sh ), then use the Desktop launchers or switch-theme-macos.sh --id preset-ssyai-dream . 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. 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.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