kongxcer555/codex-skin-builder

Codex Skin Builder is a tool for creating custom visual themes, or skins, for the Codex desktop app on macOS. It lets you turn a single picture, such as a character illustration, a screenshot, or a web image, into an installable skin package with its own colors, animated hero art, and interactive elements, while keeping Codex's real sidebar, suggestion cards, project picker, input box, and task area fully functional rather than covering them with a static image. The project explicitly avoids touching the official Codex application itself: it does not modify, unpack, or re-sign the official app or its internal packaged files. Instead, it applies its visual changes by connecting to a local Chrome DevTools Protocol debugging port that only listens on your own machine, injecting theme elements into the running interface at runtime. To build a skin, you clone the repository and prepare a horizontal image plus a matching looping animation, ideally with the main subject positioned toward one side so there's room for Codex's own text. A Python script then scaffolds a full, independently distributable skin folder from that artwork, renaming its internal identifiers so multiple skins don't conflict with each other. The generated package includes the theme's stylesheet, its injection script, a manifest file, and scripts to install, launch, verify, and restore the original appearance. The project also ships one complete reference skin you can install directly as a working example, along with documentation explaining the runtime architecture and visual design workflow. Every generated skin package is expected to go through a quality checklist covering script syntax, file paths, image dimensions, an isolated test install and restore cycle, and confirming the debugging port only binds locally. The tool includes explicit safety rules: decorative elements never block real clicks, first installs should use an isolated home directory for testing, and every skin must ship both a live cleanup path and a full restore path back to the base theme. The code itself is released under the MIT license, but that license does not cover Codex or OpenAI trademarks, the official app binary, or any third party images, characters, or artwork used in a skin, the project states plainly that it has no affiliation with OpenAI.