wtf is codex-dream-skin?

This repository is a visual theming tool for the Codex desktop app, the coding assistant application from OpenAI, available for both macOS and Windows. It replaces the app's default look with a full window background image and a color scheme that adapts to that image, while leaving the actual Codex application files and its digital signature untouched. The sidebar, suggestion cards, project selector, and input box stay fully interactive, since the tool restyles the real interface rather than covering it with a static screenshot. Under the hood, it works by connecting to the Codex app's built in debugging protocol, which is restricted to the local machine only, and injecting a theme locally rather than modifying any of the app's installed files. When a user imports their own background image, the tool analyzes it locally on their own computer to figure out brightness, dominant colors, and safe areas for text, and never uploads the image anywhere. It also automatically switches between light and dark color variants depending on the system or app appearance setting. Six built in themes are included, all generated programmatically rather than using photos or third party artwork, and a user can save and hot swap between saved themes from the macOS menu bar or Windows system tray without restarting Codex. A restore option reverts everything to the official Codex appearance and turns off the debugging port. Setup differs slightly by platform. On macOS, a user runs a shell script from the repository, or launches an installer file directly. On Windows, it targets the Microsoft Store version of Codex and requires Node.js 22 and PowerShell to run separate install and start scripts. The tool can also be installed as a reusable skill for AI coding agents that support the skills format, using a single command line install. This project is aimed at Codex desktop users who want a personalized visual appearance without altering official app files, and is not an official OpenAI product. It builds on an existing open source theming engine from another developer, released under the MIT license, and requires basic comfort running installer scripts on their operating system.