Summary

This project provides a one-click theme and skin switcher for OpenAI Codex Desktop on macOS and Windows. It enables users to personalize the application's interface using custom images, creating a tailored coding environment without modifying core application files.

How It Works

The tool utilizes Chrome DevTools Protocol (CDP) injection via localhost to apply themes. This method avoids altering the application's app.asar, binaries, or signature resources, ensuring native controls remain interactive and the core application is preserved.

Quick Start & Requirements

• Installation: macOS: Execute install.command. Windows: Run install.bat.
• Prerequisites: Codex Desktop must be installed. Node.js 22+ is recommended if using a system Node installation.
• Usage: Theme switching and persistence are managed via the application's top menu (🎨) or provided scripts. Comprehensive instructions are available in docs/manual.md.

Highlighted Details

• Theme Generation: Themes can be created from a single uploaded image (automatic color/style extraction), by running a customization script (customize.command), or via AI prompting using a provided skill file.
• Built-in Themes: Features 12 pre-designed themes inspired by popular culture (e.g., Miku, Genshin Impact, Naruto), which adapt to Codex's light/dark modes.
• Persistence: Themes can be configured to persist across application restarts through a dedicated menu option.

Maintenance & Community

Developed by HeiGeAi, this project is part of a broader initiative including AI落地 articles and AI科普 videos. Community engagement primarily occurs through a private WeChat group (invite-only) and GitHub Discussions for sharing user-created themes.

Licensing & Compatibility

Code is licensed under the MIT License. This license explicitly excludes rights to characters, trademarks, and third-party visual assets. Users are responsible for verifying and securing necessary licenses for any custom assets, especially for commercial distribution.

Limitations & Caveats

CDP injection presents a security consideration, as same-permission local processes fall within the threat boundary. Future Codex Desktop updates may necessitate project adaptations. Validation for Microsoft Store/MSIX versions on Windows is pending. Persistence mechanisms could be impacted by Store restrictions.