Restore the Default Codex Theme

Upstream instructions can change. Before running commands, compare this guide with the original GitHub repository.

macOS

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

The current script stops only the recorded injector when its process identity still matches, removes the themed launch agent, removes the live renderer skin and clears its state. It can optionally restart Codex normally.

--restart-codex closes and relaunches Codex through the normal path.
--restore-base-theme restores saved appearance keys from the upstream backup.
--uninstall removes the Desktop launchers after restoration.

If Codex is still running but the saved CDP endpoint cannot be verified, the macOS script stops safely unless you explicitly request a restart. Do not bypass that check.

Windows

powershell -NoProfile -File scripts\restore-dream-skin.ps1

The Windows restore script removes the live skin, closes the saved CDP session and reopens Codex normally. Optional flags have different scopes:

-RestoreBaseTheme restores only the saved appearance keys.
-RecoverConfigBackup performs explicit byte-for-byte recovery of a damaged configuration backup.
-Uninstall removes the created shortcuts.

Post-restore verification

Confirm the theme injector is no longer running.
Open Codex normally and check Home, Task and Diff.
Confirm sidebar, project selector, composer, menus, pets, plugins and authentication still work.
Record any remaining appearance setting before editing configuration by hand.