01 / Context
Why It Exists
Codex Desktop's default theme is generic with limited personalization. As a Xi'an Jiaotong University user, I wanted a theme that reflects campus cultural identity while maintaining readability and professionalism.
Problem
Codex Desktop has limited theme customization; manual modifications easily break compatibility. Light and dark mode adaptation requires separate handling, and theme switching may cause style anomalies.
Solution
XJTU Codex Theme provides preset light and dark theme schemes, injecting via brief local Node Inspector pulses without modifying WindowsApps, app.asar, Codex config, browser profiles, or login credentials. Supports compatibility checking, verification, and fail-safe recovery. No restart required for switching.
02 / System
Core Capabilities
- XJTU Academic Theme, Codex Skin Maker, Unbranded Template
- Injection via brief local Node Inspector pulses
- Does not modify WindowsApps, app.asar, Codex config, browser profiles, or login credentials
- Compatibility checking, verification, and fail-safe recovery
- No restart required for switching
03 / Workflow
Workflow
- Download or clone theme files
- Run theme installation script
- Select light or dark mode
- Node Inspector pulse injection takes effect
- Verify theme application results
04 / Boundaries
Security & Privacy
Security boundary: binds only to local Inspector port, target PID verification, verify/disable, reconfirmation before preview. Does not touch login state or conversation content. Does not modify WindowsApps, app.asar, Codex config, browser profiles, or login credentials.
Current Limitations
- Only supports Windows 10/11 x64, Microsoft Store version of Codex Desktop
- Depends on Codex Desktop Electron internal structure; may need adaptation after updates
- Requires Node.js 22+
- Unofficial experimental project, not affiliated with OpenAI or Xi'an Jiaotong University
05 / Roadmap
Roadmap
Completed
- Light and dark theme design
- Node Inspector pulse injection mechanism
- Compatibility checking and verification
- Fail-safe recovery mechanism
In Progress
- More Codex Desktop version adaptation
Exploring
- Community theme contribution mechanism
- Theme preview and online editor
06 / Participate
How to Participate
Issues for compatibility problems and pull requests for new theme variants are welcome on GitHub. Stable demo entry points are available from GitHub.
GitHub