| name | codex-skin |
| description | Manage Codex Dream Skin on macOS. Use when a user wants to install, customize, launch, verify, repair, update, or restore the skin; turn a personal image into a Codex banner and task background while preserving the native interface; or troubleshoot and roll back the safe local CDP theme runtime. |
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.
- For ordinary use, open the desktop
Codex Skin.command and choose an action from its menu. It is the preferred no-terminal interface for changing images, switching saved themes, verifying, and restoring.
- Verify the live result with the menu or
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 real banner, native cards, and project selector.
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.
- 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.
