What is codex-autoskin?

finderchangchang/codex-autoskin — explained in plain English

Analysis updated 2026-05-18

★ 107JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((Codex AutoSkin))
    What it does
      Image to theme
      Auto palette extraction
      Reversible install
    Tech stack
      JavaScript
      Node.js
      Chrome DevTools Protocol
    Use cases
      Custom Codex look
      Agent driven install
      Theme sharing
    Audience
      Codex users
      Vibe coders
    Setup
      Windows PowerShell scripts
      macOS double click install
      Restore command

mindmap root((Codex AutoSkin)) What it does Image to theme Auto palette extraction Reversible install Tech stack JavaScript Node.js Chrome DevTools Protocol Use cases Custom Codex look Agent driven install Theme sharing Audience Codex users Vibe coders Setup Windows PowerShell scripts macOS double click install Restore command

What do people build with it?

USE CASE 1

Send Codex a single image and have it install and apply a matching custom theme automatically.

USE CASE 2

Switch between saved themes and layouts like fullscreen or banner without touching official app files.

USE CASE 3

Restore Codex to its official look with one command if you want to undo a theme change.

USE CASE 4

Hand the theme spec to an AI agent to fine tune cropping, copy, and decorative stickers.

What is it built with?

JavaScriptNode.jsElectron

How does it compare?

	finderchangchang/codex-autoskin	zyz254009-crypto/script-to-shootable-storyboard	karpathy/notpygamejs
Stars	107	106	109
Language	JavaScript	JavaScript	JavaScript
Last pushed	—	—	2023-10-17
Maintenance	—	—	Dormant
Setup difficulty	easy	moderate	easy
Complexity	2/5	2/5	2/5
Audience	vibe coder	writer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires the official Codex app already installed and signed in once before running the install scripts.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice, under the MIT license.

So what is it?

Codex AutoSkin lets you change the visual theme of the Codex desktop app by handing it a single image. You send your Codex agent the project link along with a picture you like, tell it to install and apply the skin, and it clones the repository, extracts colors and layout from your image, and applies the new look on its own, without you touching any official Codex files. The tool works on both Windows and macOS. On Windows you clone the repository and run two PowerShell scripts, one to install a bundled starter theme and one to turn your own image into a live theme. On macOS you download and extract the project, then double click one file to install and another to pick an image, reusing the version of Node.js that already comes bundled with Codex so most users do not need to install anything extra. A theme is just a folder containing one settings file and one image, so adding or removing themes needs no code changes. Under the hood, the project injects changes into the running Codex app through a local debugging connection that only listens on your own machine, and it is designed to be fully reversible with a single restore command. It never modifies the Windows Store app package, the macOS app bundle, or Codex's internal packaged files, and your existing login, projects, and chat history are left untouched. A background watcher reapplies your chosen theme automatically if Codex restarts. The project also includes safeguards such as port checking, crash recovery, and a circuit breaker to avoid repeatedly failing in a loop. Images you use should be landscape, at least 1600 pixels wide, with the main subject positioned toward the right side and no text, watermark, or interface elements baked into the picture, and you should own the rights to whatever image you use. For people who want more control than the automatic flow gives, the project includes a specification document you can hand to an AI agent to customize cropping, text, and decorative stickers in more detail. It is released under the MIT license.

Copy-paste prompts

Prompt 1

Install this Codex skin engine from the repo link, then use my attached image to generate and apply a theme.

Prompt 2

Walk me through running quickstart.ps1 and quick-theme.ps1 on Windows to set up my first custom theme.

Prompt 3

Explain how codex-autoskin injects changes into Codex safely without touching the app bundle or my login.

Prompt 4

Show me how to switch themes and restore the official Codex look using the provided scripts.

Prompt 5

Help me pick a good source image for this tool, following its landscape and subject placement requirements.

Frequently asked questions