How to make a Codex skin without losing the plot.
Start with the official appearance controls. Add a custom Codex skin only when the extra visual layer is worth a separate local trust boundary.
Use native Codex appearance settings first
Native Codex themes are the lowest-risk option for changing the base theme, accent, foreground, background, and fonts. They do not provide an image background, but they are easy to share and restore.
Best for: color and typography changes with no external theme engine.
Use a custom Codex skin for atmosphere
A Codex skin adds an image layer behind the native interface. Keep detailed subjects away from the reading column and let the local engine adapt contrast and safe areas.
Open the Codex skin builderInstall once, then keep skins as data
CodexSkin Helper is installed separately. Individual .codexskin packages contain only an image and reviewable configuration, while the open-source Codex Dream Skin engine handles apply and restore through loopback-only CDP.
Never run a theme package that contains scripts or changes API keys, model providers, or remote Base URLs.
Check the states where real work happens
- Home: headline and suggestions stay readable.
- Task: long conversations and controls keep clear contrast.
- Diff: additions and removals remain unmistakable.
- Navigation: active and hover states are visible.
- Restore: you know how to return to the official appearance.