codex-dream-skin-manager

name	codex-dream-skin-manager
description	Use when the user wants Codex wallpaper generation, Dream Skin theme import, visual theme management, theme switching, Dream Skin verification, or restoration of the official Codex appearance

Codex Dream Skin Manager

Use ChatGPT's built-in imagegen skill to create UI-free wallpaper artwork, then use the local Manager Bridge to import and apply it through the installed Codex Dream Skin Studio engine.

Core pattern

1. Generate a raster wallpaper with imagegen; do not ask for or use an API key.
2. Keep the image wide, UI-free, without readable text, logos, cards, or people unless explicitly requested.
3. Import it with the Bridge, which writes the shared Dream Skin theme library.
4. Open or refresh the Manager App to review the theme.
5. Apply and verify through the Bridge or the visual App.

Bridge location

~/.codex/skills/codex-dream-skin-manager/manager-bridge.sh

Quick reference

manager-bridge.sh import --file /absolute/path/wallpaper.png --name "主题名称"
manager-bridge.sh list
manager-bridge.sh apply --id custom-...  # hot-applies when Codex is connected; never restarts by default
manager-bridge.sh sidebar --style auto|moonlit|forest|ember
manager-bridge.sh start
manager-bridge.sh verify
manager-bridge.sh open
manager-bridge.sh restore

Safety

• Use the existing Dream Skin Studio scripts; never patch Codex.app, app.asar, or its signature.
• Do not replace a user's wallpaper without an explicit import or apply request.
• Prefer list before applying an ID.
• Use verify after an apply or start operation.
• The Manager App and Bridge share ~/Library/Application Support/CodexDreamSkinStudio; the App refreshes this library automatically.
• Theme manifests may include sidebar (deep, night, secondary, accent, text) and ui.fontFamily; these are optional and are applied without changing Codex's native pet window.
• The settings/preferences/appearance routes inherit the active wallpaper, sidebar palette, buttons, and optional font while preserving native controls.

Lifecycle behavior

• Applying a wallpaper or sidebar style uses the hot path when Codex is already connected.
• If Codex is not running with the Dream Skin debug channel, the selection is saved without restarting Codex or interrupting the current task.
• To reattach after a normal Codex relaunch, use manager-bridge.sh start or the manager's explicit start action; the theme library remains persistent.