xnydl/codex-dream-skin

Analysis updated 2026-05-18

★ 54JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Full window custom background
      Auto light and dark themes
      Local image color analysis
      One click restore
    Tech stack
      JavaScript
      Chrome DevTools Protocol
      Shell and PowerShell scripts
    Use cases
      Personalize Codex desktop appearance
      Switch between saved themes
      Install as an AI agent skill
    Audience
      Codex desktop users
      Vibe coders
    Setup
      Run platform install script
      Requires Codex already installed

mindmap root((repo)) What it does Full window custom background Auto light and dark themes Local image color analysis One click restore Tech stack JavaScript Chrome DevTools Protocol Shell and PowerShell scripts Use cases Personalize Codex desktop appearance Switch between saved themes Install as an AI agent skill Audience Codex desktop users Vibe coders Setup Run platform install script Requires Codex already installed

What do people build with it?

USE CASE 1

Give the Codex desktop app a custom full window background and matching color scheme.

USE CASE 2

Switch quickly between several saved visual themes from a menu bar or tray icon.

USE CASE 3

Import a personal image and automatically generate a matching light and dark theme.

USE CASE 4

Install the theme as a reusable skill inside a skills compatible AI agent.

What is it built with?

JavaScriptNode.jsPowerShellChrome DevTools Protocol

How does it compare?

	xnydl/codex-dream-skin	ahouseofbards/bonfire-jellyprofiles	evaildev/noschibsgiven
Stars	54	54	54
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	moderate	moderate	easy
Complexity	2/5	3/5	1/5
Audience	vibe coder	ops devops	general

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the official Codex desktop app already installed, plus Node.js 22 and PowerShell on Windows.

Licensed under MIT, which allows free use, modification, and commercial use as long as you keep the copyright notice.

In plain English

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.

Copy-paste prompts

Prompt 1

Explain how this project changes the Codex desktop app's appearance without modifying its official files.

Prompt 2

Walk me through installing this theme on macOS and switching to the built in dream preset.

Prompt 3

Help me prepare a custom 2560x1440 background image that works well with this tool's auto color scheme.

Prompt 4

Show me how to fully restore Codex to its default appearance using this project's restore option.

Frequently asked questions

What is codex-dream-skin?

A theming tool that gives the Codex desktop app a customizable, animated visual skin without modifying its official application files.

What language is codex-dream-skin written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, PowerShell.

What license does codex-dream-skin use?

Licensed under MIT, which allows free use, modification, and commercial use as long as you keep the copyright notice.

How hard is codex-dream-skin to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-dream-skin for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.