Restore guide

Restore the Default Codex Appearance

Use the platform's recorded restore workflow to stop the injector, close the local CDP session, and reopen the official app.

Restore on Windows

Use the Desktop Restore shortcut or run the repository script. The flag below restores only the appearance keys saved during install.

.\scripts\restore-dream-skin.ps1 -RestoreBaseTheme

Restore on macOS

Double-click Codex Dream Skin - Restore.command or run the installed restore script.

~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh

What stays in place

  • The official Codex application and signature
  • Threads, projects, pets/plugins, and authentication state
  • API keys, Base URLs, and model-provider settings
  • User images and logs in the Dream Skin state directory unless you remove them separately

Verify the restore

Confirm that Codex reopens without the theme and that the loopback debugging session has closed. Use the platform verification or doctor script if the state is unclear.

If restore fails

Do not delete state files first. Preserve the logs and recorded state, close unverified Codex processes manually if instructed, and open a GitHub Issue with your platform and exact error.