codex-dream-skin-studio

Install, customize, launch, verify, repair, update, or restore Codex Dream Skin Studio on macOS. Use when a user wants to turn a personal image into one continuous full-window Codex wallpaper with adaptive readability layers while preserving the native interface, or needs safe CDP theme troubleshooting and rollback.

Jump to install

Repository: Fei-Away/Codex-Dream-Skin
Last source activity: August 12, 2026 at 03:24
Detected SKILL.md language: English
Stars: 13,950
Forks: 1,346

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Fei-Away/Codex-Dream-Skin --skill codex-dream-skin-studio

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

100 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

codex-dream-skin

Apply, launch, verify, repair, update, or restore a full decorative skin for the Windows Codex desktop app. Use when the user asks for a Codex theme that goes beyond official color settings, wants the pink-purple Dream/Fiona-style interface, needs the skin reapplied after a Codex update, or needs a safe rollback without modifying WindowsApps or app.asar.

2026-08-12

View all from this repository

Codex Dream Skin Studio

This file is an optional Codex capability entry. The delivery is a complete standalone project; users do not need to install it as a Skill.

Workflow

Run Install Codex Dream Skin.command from the complete project folder.

Run Customize Codex Dream Skin.command, choose an image in Finder, and enter a theme name.

To add a complete downloaded pack, use the native menu's “导入主题 ZIP…”. Accept ordinary .zip only. Every new official Studio pack contains manifest.json, non-empty theme.json, non-empty locally validated theme.css, exactly one registered background, and optional license/signature files; the trusted local simplified format contains exactly theme.json, theme.css, and its referenced image. Import into saved themes without changing the active theme. A manually extracted complete three-file directory may instead be moved into the saved themes folder. Previously saved legacy themes without CSS remain switchable but inject no extra CSS.

Verify the live result with Verify Codex Dream Skin.command. A pass requires a visible native sidebar and composer, no horizontal overflow, non-interactive decoration, and—on the home route—a continuous wallpaper with live native heading, project controls, and any suggestion cards exposed by the current Codex version.

Restore the official appearance with Restore Codex Dream Skin.command.

Guardrails

Never modify the official .app, app.asar, or its code signature.

Use the official Codex app's signed Node.js runtime only after validating its signature, Team ID, architecture, and minimum version.

Bind CDP to loopback, verify that the listener belongs to Codex, and reject non-Codex renderer targets.

Preserve all native cards, navigation, project selectors, task content, composer controls, and keyboard focus.

Theme images must be UI-free wallpapers. Paint one 16:9 image continuously across the window; keep home expressive and task routes quieter. appearance: auto follows Codex/native or system appearance rather than image brightness.

Theme-pack import does not support .dreamskin; reject traversal, links, nested archives, ambiguous roots, size/count abuse, and packs that fail the existing theme/image payload checks.

Keep decoration at pointer-events: none.

Require explicit authorization before restarting an already-running Codex instance.

Stop an injector only when its recorded PID, executable, command line, and start time all match.

Key resources

README.md: user installation and customization guide.

scripts/injector.mjs: CDP connection, injection, removal, verification, and screenshots.

assets/dream-skin.css: live native interface styling.

assets/renderer-inject.js: idempotent DOM integration and cleanup.

scripts/doctor-macos.sh: signed-runtime, payload, and optional live-session self-check.

references/qa-inventory.md: release and visual acceptance criteria.