Install a skin
Three steps from the index to a reskinned workspace, with a clear safety boundary.
Safety boundary
Skins work over 127.0.0.1 loopback, never modify the
Codex app, never read your API key, and are reversible with one click. Stay local and review
each source before applying.
-
Pick a skin
Browse the index and open any skin page. Note its category, platform, and the copyable install prompt.
-
Copy the install prompt
On the skin page, click Copy next to the install prompt or command. The exact text is ready to paste.
-
Apply it in Codex
Paste the prompt into Codex Desktop, or run the command in Codex CLI. The theme changes in place and is reversible.
Platform steps
Codex Desktop skins apply through an engine preset or by pasting an agent prompt. Copy the prompt from the skin page and paste it into Codex, or use your engine's "apply" button.
Codex, switch my workspace to the skin I provide and apply its palette as the active theme.On macOS Apple Silicon and Windows, the same engine handles one-click restore.
For Codex CLI, drop a .tmTheme into your themes
directory and select it with the /theme command.
# 1. Put a .tmTheme file where Codex CLI reads it
mkdir -p ~/.codex/themes
# 2. Select it from inside Codex CLI
/theme <your-theme-name>Troubleshooting & recovery
- Restore the default: use your engine's one-click restore, or run the source's restore command. Skins never overwrite official updates.
- Broken preview: if a source image is missing you'll see "Source may have changed" — the install prompt and link still work.
- macOS quarantine: if a downloaded engine won't open, allow it in System Settings → Privacy & Security, then retry.
Prefer a longer walkthrough? Read the tutorials.