Browse, install, create, validate, and publish free themes for Codex Desktop.
Website · Browse themes · Create a theme · Documentation · npm
Get Codex Theme is completely free and built in public. Anyone can publish a theme, improve the CLI or schema, fix the website, strengthen validation, update the docs, or propose a new feature.
Unofficial themes for Codex Desktop. Not affiliated with or endorsed by OpenAI. The compatibility runtime does not patch the signed Codex application and does not add themes to
Settings > Appearance.
Codex Desktop Appearance and Codex CLI themes are separate systems. The
desktop app exposes native appearance controls; the CLI uses /theme and
supports custom .tmTheme files. Artwork-heavy packs in this repository are
unofficial, stay outside the signed app, and include an explicit restore path.
- Codex Appearance settings: themes, colors, fonts, and sharing
- Official Codex app settings reference
- Official Codex CLI customization reference
- Browse free Codex themes
- One-command installation — download, validate, install, and select a published theme with one pinned CLI command.
- Codex-assisted creation — start on the website, give the generated Session Prompt to Codex, and let the agent build the pack and run deterministic checks.
- Real local QA — validate static assets, render privacy-safe previews, test the candidate in Codex, and prove restore before publication.
- Safe and reversible — installation and selection never silently restart Codex, and the previous local state remains restorable.
- Automatic publication — the Registry independently validates the author-confirmed archive before making it public.
- Open source — the website, CLI, schema, creator Plugin, validation tools, free themes, and compatibility runtime are all developed in this repository.
Node.js 22 or later is required.
npx --yes get-codex-theme@0.7.0 use codexhubuse downloads the pack, verifies its checksums and manifest, installs it, and
selects it. It never restarts Codex. Inspect the result before starting the
optional visual compatibility layer:
npx --yes get-codex-theme@0.7.0 status --json
npx --yes get-codex-theme@0.7.0 doctor --json
npx --yes get-codex-theme@0.7.0 launchIf Codex is already running without the required loopback endpoint, launch
stops with RESTART_REQUIRED. Save active work first, then explicitly run:
npx --yes get-codex-theme@0.7.0 launch --restartRestore the previously selected state at any time:
npx --yes get-codex-theme@0.7.0 restoreBrowse every published command at getcodextheme.com/themes.
- Browse the theme gallery.
- Review its public Home, Task, and narrow-window previews.
- Copy the pinned install command.
- Run
statusanddoctor. - Launch only after deciding whether a running Codex task may be restarted.
- Use
restorewhenever you want to return to the previous state.
The CLI also supports list, install, apply, use, status, doctor,
launch, and restore. See the CLI reference.
- Open Create and describe the theme you want.
- Copy the generated Session Prompt into a new Codex task.
- Codex creates original artwork and a complete theme pack, renders privacy-safe previews, and runs strict validation.
- After you explicitly approve local testing, Codex installs the exact candidate and checks real Codex surfaces, narrow layouts, and restore.
- Review every public field and preview on the website, choose your public creator identity, and accept the publication terms.
- The same agent session submits the author-confirmed archive. The Registry validates it again before automatic publication.
Start at getcodextheme.com/create. The full agent contract is documented in Agent theme authoring.
Everyone is welcome to contribute. Useful contributions include:
- new original themes and improved component coverage;
- CLI, installer, restore, and cross-platform fixes;
- schema and validation improvements;
- website, accessibility, SEO, and documentation changes;
- tests, security hardening, and reproducible bug reports.
git clone https://github.com/ViisOpen/get-codex-theme.git
cd get-codex-theme
npm install
npm testBefore opening a pull request:
- read CONTRIBUTING.md;
- follow the Code of Conduct;
- use the theme contribution guide for artwork, screenshots, QA, and licensing;
- report vulnerabilities privately through SECURITY.md;
- include tests and before/after screenshots when behavior or visuals change.
Bug reports and theme proposals have dedicated Issue templates.
Theme gallery
↓
Pinned CLI command
↓
Checksum + manifest + asset validation
↓
Atomic local installation and selection
↓
Explicit compatibility launch
↓
Status, doctor, pause, switch, or restore
Creation and publication use an additional trust boundary:
Website brief → scoped Session Prompt → Codex creates and validates
→ author-approved local QA → exact website preview and terms
→ short-lived Publish capability → independent Registry validation
The public theme format accepts bounded manifest fields, declared assets, and visual tokens. Public validation rejects raw executable JavaScript, arbitrary HTML/CSS, unsafe paths, undeclared files, invalid colors, missing rights metadata, and unsupported licenses.
| Surface | Status |
|---|---|
| Theme browsing and documentation | Any modern browser |
| Theme creation, validation, previews, and packing | Node.js 22+ |
| Live visual compatibility layer | macOS and Windows when declared and tested by the pack |
| Linux live CDP operation | Unsupported |
Native Settings > Appearance integration |
Not claimed |
| Signed Codex application patching | Never performed |
| Automatic restart of active Codex tasks | Never performed |
Codex appearance capabilities can change between releases. Each published pack must declare its supported platforms and include platform-specific install/apply/restore evidence. The runtime binds debugging only to loopback, verifies the target process, and fails closed when compatibility cannot be proven.
Read the compatibility model, installation and restore model, and security model before changing live runtime behavior.
The optional Plugin bundles separate creation and management Skills. Add this repository as a marketplace, then install the versioned Plugin in Codex:
codex plugin marketplace add ViisOpen/get-codex-theme
codex plugin add get-codex-theme@get-codex-themeStart a new Codex task after installation so the Skills are discovered. Plugin commands keep live install, launch, and restart actions behind explicit authorization.
Before release, every declared asset must pass strict validation:
npx --yes get-codex-theme@0.7.0 validate ./my-theme --strict-assets
npx --yes get-codex-theme@0.7.0 coverage ./my-theme
npx --yes get-codex-theme@0.7.0 render-preview ./my-theme --state allpack repeats strict validation, includes only declared assets and rights
metadata, and writes a per-file checksums.sha256 manifest. Creation itself is
filesystem-only: it never installs, activates, launches, or injects a theme.
Live testing is a separate, author-approved phase.
Publishing keeps the validation and publication capabilities separate inside one proof-of-possession-bound agent session. The CLI reads only manifest-declared files, creates its ZIP in an OS temporary directory, removes it after the request, and submits only to Get Codex Theme over HTTPS or loopback during local development. The Registry stores the original archive privately, independently validates and sanitizes it, and consumes the short-lived publication capability when the attempt completes.
See Contributing a theme and Releasing the CLI and Plugin.
| Dark | Light |
|---|---|
| Codex Hub | Cloud Atelier |
| Obsidian Orbit | Sage Workshop |
| Aurora Glass | Solar Paper |
| Midnight Grid | Rose Quartz |
| Signal Drive | Alpine Daybreak |
| Desert Eclipse | Citrus Atelier |
| Inkstone Garden | Paper Grove |
| Neon Monsoon | Porcelain Tide |
| Velvet Observatory |
Every free pack includes master artwork, responsive derivatives, public Home and Task previews, narrow-layout evidence, complete visual tokens, checksums, and an explicit asset license.
| Path | Purpose |
|---|---|
packages/theme-schema |
Canonical manifest.json contract |
packages/theme-cli |
Create, validate, package, list, install, apply, and restore commands |
apps/website |
Gallery, creator flows, publication APIs, community features, SEO, and deployment packaging |
themes/free |
Complete redistributable theme packs |
plugins/get-codex-theme |
Codex creator and theme-management Skills |
runtime and platforms |
Optional macOS/Windows loopback compatibility layer |
docs |
Format, compatibility, safety, installation, contribution, and release references |
This public monorepo contains the reusable toolkit and hosted website application. Production secrets, service resource IDs, live database and object data, publisher uploads, private reports, and local deployment state stay outside Git.
- Online documentation
- Getting started
- Theme pack specification
- Component authoring paths and coverage
- Agent theme authoring contract
- Open-source boundary
- Installation and restore model
- Compatibility
- Security model
- Contributing a theme
- Image palette engine
- Companion runtime
- Changelog
npm install
npm test
npm run test:themes
npm run test:themes:brand
npm run dev:websiteThe website generates its public schema and first-party theme delivery folders from canonical monorepo sources before development, build, and tests. Do not commit generated public delivery folders. See Website monorepo boundaries.
Security-sensitive reports belong in the repository's private security advisory form, not in public issues.
Code is licensed under the MIT License. Theme images retain the license declared by each pack; the repository license does not grant rights to third-party assets, characters, logos, likenesses, or trademarks. See NOTICE.md and THIRD_PARTY_NOTICES.md.