GptSkin Documentation
Build and apply image-backed themes to the Codex workspace with the open-source GptSkin Skill.
What is GptSkin?
GptSkin builds image-backed themes for the Codex desktop app. After installing the open-source Skill, attach your own image or ask Codex imagegen to create one locally first. Every paid custom theme then follows the same image pipeline.
Themes are applied at runtime by injecting CSS variables, backgrounds, and controlled decorative layers through a loopback-only (127.0.0.1) CDP connection. GptSkin never modifies the official app package, app.asar, signatures, your API Key, or your Base URL — and one click restores the default theme.
GptSkin is an independent product, not affiliated with or endorsed by OpenAI.
Quick Start in 3 Steps
- Install the Skill — set up the open-source GptSkin Skill for Codex. See the Installation guide.
- Provide an image — attach your own, or ask Codex imagegen to create a local image first, then pass it to the same
--imageflow. - Apply it — confirm, and the theme is injected into your running Codex workspace instantly. Say
Restore the default Codex themeanytime to revert.
Free Preset Themes
Six presets are included free — no account required:
| Preset | Style |
|---|---|
| dark-void | Deep-space dark minimalism |
| sunset-glow | Warm dusk oranges and pinks |
| aurora-borealis | Green and violet northern lights |
| snow-peak | Calm alpine light |
| city-lights | Neon city at night |
| minimal-light | Clean, bright, distraction-free |
Apply one directly:
node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --preset dark-voidNext Steps
- Installation guide — system requirements, Skill setup, API Key, troubleshooting.
- Security architecture — how GptSkin works without touching your Codex files or conversations.