Codex Theme Studio is a local-first visual theme editor and hot-reload theme manager for Codex Desktop on macOS, built in JavaScript. It runs locally, previews themes, and supports heat-up/rollback via a constrained CDP session.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Codex Theme Studio — Codex Desktop 可视化主题编辑器 is a local-first theme studio for macOS Codex Desktop. It designs themes in the browser, saves locally, and hot-applies via a restricted CDP session. It is also a theme manager, theme editor, and skinning tool with live preview, modular drag-and-drop, dark/light theme support, background image handling, hot update, and one-click restoration of native appearance.
How it works
Browser Studio provides preview and editing, while Local Helper stores themes, manages process state, and generates restricted styles. Codex only receives deterministic CSS and fixed homepage text/visibility config at runtime. A deterministic renderer generates CSS from a whitelist and applies via CDP session to Codex Desktop. If renderer reload occurs, Helper re-applies automatically. The architecture includes a Browser Studio, Local HTTP Server (127.0.0.1), ThemeStore, ThemeSupervisor, and Deterministic Renderer using a fixed DOM strategy.
Getting started
Environment requirements include macOS, Codex Desktop installed, Node.js 22+, and a browser to open the local Studio. To start:
git clone https://github.com/JasonSTong/codex-theme-studio.git
cd codex-theme-studio
npm start
On successful start, it prints and opens an address like:
http://127.0.0.1:54321/?token=<每次启动随机生成>
For no-open start:
npm run start:no-open
Status can be checked with:
node src/cli.mjs status
Recent releases
Latest release: none. The README lists a public preview version 0.0.1, platform macOS, runtime Node.js 22+.
Traction
Stars: 50 Forks: 1 Open issues: 0
Behind the repo
Repository is JasonSTong/codex-theme-studio with topics including cdp, codex, codex-desktop, customization, developer-tools, javascript, local-first, macos, nodejs, openai-codex, theme-editor, theme-manager.
Caveats
License: none listed. Created 2026-07-16, last_push 2026-07-17. No runtime third-party dependencies at present; if package.json adds dependencies later, run npm install. Themes use local storage and do not write Codex renderer localStorage. Data directory is ~/Library/Application Support/CodexThemeStudio/. The project is described as an independent tool not part of OpenAI products.