Preview the real tradeoffs
Compare the original interface with your skin, then tune wallpaper opacity, panel transparency, blur, radius, and accent color against a working Codex-style conversation.
Create a custom theme for Codex Desktop with your own background, readable glass panels, restrained colors, and native controls. Preview every choice online before anything reaches your Mac.
The interactive Codex Skin preview maps each control to a limited theme token. Backgrounds and surfaces can change while native buttons, focus states, and destructive actions remain protected.
npx codex-skin@latest apply theme_previewCodex Skin is an independent browser-based theme studio for Codex Desktop on macOS. It combines curated visual presets, a live editor, and a planned local installer so people can personalize backgrounds, surfaces, colors, and type without writing CSS or changing the official application bundle.
The goal is not to turn Codex into a noisy gaming dashboard. It is to make a workspace you may keep open for hours feel personal while preserving legibility, familiar controls, keyboard behavior, and system feedback. The editor therefore treats a theme as a small set of controlled design choices rather than arbitrary executable code.
Compare the original interface with your skin, then tune wallpaper opacity, panel transparency, blur, radius, and accent color against a working Codex-style conversation.
Preserve send, microphone, settings, destructive, disabled, hover, and focus semantics by default. A beautiful theme should never make the app harder to understand.
The MVP is designed around separate local theme storage, signed packages, compatibility checks, and a restore command that returns Codex to its official appearance.
Each preset starts with a distinct atmosphere, but the useful part is the system underneath: readable text, restrained glass, protected actions, and room for your own image.
The Codex Skin MVP is planned to keep theme assets and state outside the official application bundle. The local tool will verify a signed theme package, apply controlled styling, run a health check, and retain a direct path back to the original appearance.
npx codex-skin@latest restoreAdjust a curated preset or upload a JPG, PNG, or WebP image. Your browser preview responds immediately, so you can fix contrast before installation.
The planned service creates a theme ID, processed background, compatibility requirements, file hashes, and a signature. Theme data cannot include arbitrary JavaScript.
Paste one npx command, approve local execution, and let the macOS tool verify the package, store it separately, apply it, and report the health-check result.
Use the restore command whenever you want the official appearance. Routine updates should reapply a compatible skin; major changes should trigger a safe fallback instead.
The MVP pricing model is a one-time purchase for the complete preset library, custom images, and compatibility updates. The studio preview remains free while account, checkout, and device authorization are being implemented.
Codex Skin is being designed as a visual layer, not a replacement client. The planned local tool binds communication to 127.0.0.1, stores themes under the user Library directory, and does not need to read conversations, project code, API keys, or payment details. The website produces configuration and assets; the local engine translates those approved values into limited styling.
Compatibility cannot be promised for every future Codex release. The honest guarantee is narrower: routine updates should be detected and handled automatically, while structural changes must stop injection and return the app to its default appearance. Compatibility can resume after a signed rule update passes a new structure check.
Current status: the online editor is an interactive product preview. Account login, payment, signed theme delivery, the npm installer, and update recovery remain part of the MVP implementation. Last reviewed July 16, 2026.
Clear answers about what exists today, what the macOS MVP will do, and where the product deliberately draws a boundary.
Codex Skin is an independent visual theme studio for Codex Desktop. It lets you preview curated themes or turn your own image into a controlled theme configuration for backgrounds, surfaces, colors, type, blur, and corner radius.
No. Codex Skin is an independent product and is not affiliated with, endorsed by, or maintained by OpenAI. Codex and OpenAI are trademarks of their respective owner.
The first release is designed for Codex Desktop on macOS, including Apple Silicon and Intel Macs. Windows support is outside the first MVP and will be evaluated after the macOS workflow is stable.
The planned installer keeps themes and state in a separate user directory and does not patch the official app bundle or its code signature. Theme packages contain controlled configuration and assets, not arbitrary JavaScript.
Yes. The studio preview accepts JPG, PNG, and WebP images and lets you test opacity, panel transparency, blur, radius, and accent choices. Private images remain local during the current browser preview.
The planned flow creates a signed theme ID and a single npx command. You paste that command into Codex, approve local execution, and the installer verifies, downloads, applies, and checks the theme on your Mac.
Yes. The MVP specifies a one-command restore flow: npx codex-skin@latest restore. It disables reinjection, removes active theme styling, restarts Codex normally, and keeps downloaded themes available for later use.
Routine updates are planned to trigger compatibility checks and reapply the active theme. If a major update changes the interface structure, the local tool should stop injection and fall back to the official appearance until compatibility is restored.
Try the visual controls, compare the original view, and find a readable direction for your future theme. No account or upload is required for the current preview.