aiwenjie777/codex-skin-skill — explained in plain English
Analysis updated 2026-05-18
Customize the Codex Desktop app's appearance by sending it a single image in conversation.
Switch between several previously saved skins by name without opening a terminal.
Verify a newly applied skin with an automatic screenshot before deciding to keep it.
Restore Codex's original official appearance at any time with a single spoken instruction.
| aiwenjie777/codex-skin-skill | emadd/mise-en-claude | peppy/dotfiles | |
|---|---|---|---|
| Stars | 48 | 48 | 48 |
| Language | Shell | Shell | Shell |
| Last pushed | — | — | 2026-07-01 |
| Maintenance | — | — | Active |
| Setup difficulty | easy | easy | moderate |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires the official Codex Desktop app already installed, works on both macOS and Windows through the accompanying plugin.
Codex Skin is an unofficial tool that lets you customize the appearance of the Codex Desktop app using a single image, generating a home banner and a low distraction background for your tasks while leaving the sidebar, project picker, task content, and input box as the original native controls rather than a screenshot overlay. The main way to use it is entirely through natural language inside a Codex conversation, after installing the accompanying plugin. You can simply say things like install Codex Skin, use this image to customize Codex Skin, list installed skins, switch to a named skin, verify the current skin and take a screenshot, or restore the official Codex appearance. You attach an image directly to the conversation rather than copying it into a specific folder yourself, and the skill handles installation, saving, applying, and verifying the theme, asking for confirmation first if restarting Codex is required. This works on both macOS and Windows, with each platform running its own set of safety scripts behind the scenes. A Codex Skin.command file is also created on macOS as a manual fallback entry point if you prefer not to use natural language. On macOS, the underlying engine is installed to a folder under your home directory, and your images, saved themes, and logs are stored in Application Support. The skin process does not read or modify Codex's own config.toml file. For safety, the tool works by injecting into Codex through the Chrome DevTools Protocol listening only on localhost, and the README states it does not modify the official Codex installation directory, binaries, app bundle signature, API key, or base URL. It also notes that any characters or imagery shown in the preview screenshots are only for illustrating the visual effect, and you should confirm rights yourself before using them commercially. This project is built on top of Fei-Away/Codex-Dream-Skin and is released under the MIT License. It is not affiliated with OpenAI.
A Codex Desktop customization tool that generates a themed banner and background from a single image, controlled entirely through natural language conversation.
Mainly Shell. The stack also includes Shell, PowerShell, Codex.
You can use, modify, and share this freely, including commercially, as long as you keep the original copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.