zhjgo/codex-skin-manager

Codex Skin Manager is a cross platform desktop tool for macOS and Windows that lets you change the visual appearance of the ChatGPT and Codex desktop clients. It works without modifying, unpacking, or replacing any of the official application's core files. Instead it connects through the Chrome DevTools debugging port already exposed by those Electron based apps and injects custom CSS styles and small JavaScript effects into a sandboxed layer, so official updates to ChatGPT or Codex should not conflict with it. When you apply a skin the tool also writes matching settings into the underlying app configuration, such as the Codex config file on macOS, so the system light or dark base color and editor theme switch together with the visual skin, and restoring the original look reverses all of it in one step. A built in cleanup script removes every injected element, style, saved state, and animation timer when you switch or remove a skin, so leftover styling from a previous skin does not carry into a new one. The project ships with several ready made themes, including an ink wash cultivation fiction style, a bright wasteland science fiction look, a pink and cyan cyberpunk theme, an Evangelion inspired theme with a NERV style warning interface, a Hatsune Miku theme with falling cherry blossoms, and a couple of pink purple and traditional Chinese ink style themes. Each bundle includes character artwork the README describes as fan made tribute content, with copyright belonging to the original rights holders. To run it you need Node.js 18 or later and an installed copy of the Codex or ChatGPT desktop client. You clone the repository, run npm install, and start it in development mode with npm start. It can also be packaged into a macOS dmg or a Windows installer using electron-builder, and the README notes a mirror registry to use if GitHub downloads are rate limited during a Windows build. Adding a new skin means creating a folder under skins with a configuration file, a stylesheet, an injection script, and a reference image, then registering its cleanup keys in the purge script so it can be fully removed later. The README states the tool makes no network requests of its own, all styling happens over the local machine, and it does not collect, intercept, or modify chat data, API tokens, or account credentials. The project is released under the MIT license.