CodexSkin

Safety model

What CodexSkin does — and does not do

CodexSkin is an unofficial local theme runner for Codex Desktop. It makes the interface personal without repackaging, patching, or re-signing Codex.

Local-only connection

The runner starts Codex Desktop with a debug port bound to 127.0.0.1, not your LAN or the public internet.

App identity check

Before opening a debug port, the runner checks the Codex bundle/executable identity and platform signature. Dev builds require an explicit bypass flag.

No app file patching

CodexSkin applies CSS and background layers to the live renderer. It does not modify the Codex installer, app bundle, app.asar, or code signature.

Credentials are out of scope

Theme packs contain artwork and theme settings. The runner does not need to read or rewrite API keys, auth files, base URLs, or model provider settings.

Restore is the off switch

Restore removes the live skin best-effort, closes the themed session by relaunching Codex normally, and returns to the official appearance.

CDP is powerful

Chromium DevTools Protocol can inspect and control a running renderer. Binding it to 127.0.0.1 prevents network exposure, but it is still unauthenticated for trusted local users/processes. Avoid running unknown local software while a themed session is active, and run Restore when you no longer need the theme.

Independent project

CodexSkin is not affiliated with, endorsed by, or sponsored by OpenAI. Codex and OpenAI trademarks belong to their owners. Theme artwork is distributed as CodexSkin assets only; it does not represent official Codex visuals.

Ready to try it? Download the runner or browse the skin gallery.