English · 简体中文
An open-source, offline theme app for Codex Desktop on macOS. It gives the Codex workspace a visual identity while keeping the official app intact and making every change reversible.
AI ThemeStore is an independent, unofficial project. It is not affiliated with, endorsed by, or sponsored by OpenAI.
This sanitized, high-fidelity showcase brings together four visual worlds from the wider ThemeStore catalog: Fortune Code Workshop, Azure Lotus Dharma, Ember Ninja Legacy, and Silver Nocturne Rose. It demonstrates both New Chat and active task surfaces without using real account, project, or conversation data.
The ninja panel uses the original, non-franchise Ember Ninja Legacy artwork.
No third-party character fan art is included in this repository.
- A native SwiftUI app for browsing, applying, verifying, and restoring themes
- Three bundled redistributable themes: Minimal Glass, Cyber Neon, and Pink Future City
- An open, local
theme.jsonformat for creating your own Codex themes - A loopback-only theme runtime with transactional switching and rollback
- Signature checks for the official Codex app and its bundled Node.js runtime
- No accounts, analytics, cloud registry, remote devices, or automatic updates
AI ThemeStore is a hybrid native macOS app: Swift and SwiftUI provide the application interface, while a local JavaScript and CSS theme engine handles Codex theming, verification, and recovery.
| Layer | Technology | Responsibility |
|---|---|---|
| Native app | Swift, SwiftUI | Theme library, controls, status, and user-facing recovery |
| Theme engine | JavaScript (ESM), CSS | Apply themes and verify New Chat and active task surfaces |
| Lifecycle tools | POSIX shell | Start, pause, restore, diagnose, and build the app |
| Build system | Swift Package Manager | Compile and package the native macOS application |
GitHub's language label is based on source-code byte count, so it may show JavaScript even though the user-facing application is native SwiftUI.
Codex is a living product, so a durable theme cannot be just a wallpaper or a collection of fragile selectors. The theme engine is built around a few practical lessons:
- Theme the complete workflow. New Chat and active tasks must share the same visual language, including cards, editors, sidebars, and layered panels.
- Adapt to the visible surface. Modern app shells may contain hidden or transitional layers. The runtime targets the visible main surface instead of assuming the first matching element is the one users see.
- Preserve interaction and readability. Glass, opacity, blur, text contrast, focus states, and responsive layouts are treated as one system.
- Verify after applying. A theme switch is only complete after the runtime confirms the expected New Chat and task surfaces; otherwise it rolls back.
- Keep customization reversible. The engine does not patch Codex binaries,
app.asar, application signatures, API keys, or service URLs.
These constraints make themes feel integrated with Codex while keeping the customization boundary understandable and recoverable.
Download the latest build from GitHub Releases.
Requirements: macOS 13 or newer, the official Codex Desktop app, and Xcode Command Line Tools.
git clone https://github.com/hackergene/AI-ThemeStore.git
cd AI-ThemeStore
./scripts/build-app.sh
open "dist/AI ThemeStore.app"The build script creates the app locally. It does not modify or re-sign the official Codex app.
- Open AI ThemeStore.
- Select a local theme and choose Apply Theme.
- The app restarts Codex and verifies the themed New Chat and task surfaces.
- Choose Restore Codex Appearance whenever you want the native look back.
Custom themes live in:
~/Library/Application Support/AIThemeStore/themes
Each theme is a folder containing a theme.json file and its referenced local
assets. See the theme format guide for the schema and
a minimal example.
./tests/run-tests.shAI ThemeStore works offline and contains no telemetry or account code.
Its debugging connection is bound to 127.0.0.1 only. Because a local debugging
port is sensitive while a theme is active, avoid running untrusted local
software at the same time. Read the full boundary in SECURITY.md.
This repository is intentionally focused on a small, auditable, offline Codex theme experience. The broader theme catalog and hosted browsing experience are available at themestore.ai.
Contributions are welcome. Please read CONTRIBUTING.md before opening an issue or pull request.
The source code and the three original bundled themes are licensed under the MIT License. OpenAI and Codex names, official application UI, and other third-party marks are excluded; see NOTICE.md.