codex-document-mode-macos

name	codex-document-mode-macos
description	Install, launch, verify, repair, update, or restore CODEX Document Mode on macOS. Use when a user wants formal document presentation, prose guidance, or circle/cross feedback in official Codex Desktop without modifying the official app.
compatibility	macOS, official Codex Desktop app, signed bundled Node.js 20 or newer

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

1. Run Install Codex Dream Skin.command from the complete project folder.
2. Run Start Codex Dream Skin.command to launch or reapply the bundled preset-codex-document.
3. Verify the live result with Verify Codex Dream Skin.command. A pass requires a visible native sidebar and composer, no horizontal overflow, and a document shell for assistant messages.
4. 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.
• Document mode never paints a full-window wallpaper. Scope its CSS to assistant document shells and the local composer feedback board.
• The prose wrapper is temporary and limited to one real native send action; it must restore the visible original draft on send, pause, remove, reload, reapply, restore, and exit.
• The feedback board recognizes only high-confidence red circles and crosses, appends editable feedback text, and may click only the native send button under the documented empty-draft conditions.
• 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.