Get Codex Theme

The open theme-pack standard, free themes, creation tools, and reversible compatibility runtime behind GetCodexTheme.com.

Unofficial themes for Codex Desktop. Not affiliated with or endorsed by OpenAI.

This repository contains only the reusable public toolkit. The hosted website, commerce services, customer uploads, concept-preview catalog, and production deployment configuration live in a separate private repository.

What is included

• packages/theme-schema — canonical manifest.json contract.
• packages/theme-cli — create, validate, package, list, install, apply, and restore commands.
• themes/free — sixteen complete, redistributable free theme packs.
• skills/create-codex-theme — optional Codex Skill with standalone Python tools.
• runtime and platforms — optional macOS/Windows CDP compatibility layer.
• docs — pack format, compatibility, safety, installation, and contribution requirements.

Quick start

Node.js 20 or later is sufficient for the CLI.

node packages/theme-cli/bin/get-codex-theme.mjs list
node packages/theme-cli/bin/get-codex-theme.mjs validate themes/free/aurora-glass
node packages/theme-cli/bin/get-codex-theme.mjs create my-theme --name "My Theme" --mode dark --output ./themes/local
node packages/theme-cli/bin/get-codex-theme.mjs pack themes/free/aurora-glass --output aurora-glass-v1.0.0.zip
node packages/theme-cli/bin/get-codex-theme.mjs install themes/free/aurora-glass
node packages/theme-cli/bin/get-codex-theme.mjs apply aurora-glass
node packages/theme-cli/bin/get-codex-theme.mjs status

Before releasing a theme, require every declared asset:

node packages/theme-cli/bin/get-codex-theme.mjs validate themes/free/aurora-glass --strict-assets

pack repeats strict release validation, includes only declared theme assets and rights metadata, and writes a per-file checksums.sha256 manifest. Upload that ZIP to the community publisher portal; the registry independently validates it again before human review.

Free themes

Dark	Light
Obsidian Orbit	Cloud Atelier
Aurora Glass	Sage Workshop
Midnight Grid	Solar Paper
Signal Drive	Rose Quartz
Desert Eclipse	Alpine Daybreak
Inkstone Garden	Citrus Atelier
Neon Monsoon	Paper Grove
Velvet Observatory	Porcelain Tide

Every free pack includes master artwork, responsive derivatives, Home/Task/Narrow previews, complete tokens, and an explicit per-theme asset license.

Compatibility

The optional runtime launches Codex with a loopback-only DevTools port and injects responsive art and palette CSS. It never patches the signed Codex application and does not add themes to Settings > Appearance.

node packages/theme-cli/bin/get-codex-theme.mjs install aurora-glass
node packages/theme-cli/bin/get-codex-theme.mjs apply aurora-glass
~/.codex/get-codex-theme/bin/start-macos.sh --restart

install accepts a local directory, manifest.json, downloaded .zip, or a published theme id. It validates and copies the pack but never changes the active theme or restarts Codex. Use apply <theme-id> to select an installed pack, status to inspect local state, and restore to restore the previous pointer.

Documentation

• Getting started
• Theme pack specification
• Open-source boundary
• Installation and restore model
• Compatibility
• Security model
• Contributing a theme
• Companion runtime

Development

npm test
npm run test:themes
python3 skills/create-codex-theme/scripts/theme_pack.py validate themes/free/aurora-glass

Code is licensed under the MIT License. Theme images keep the license declared by each pack; the repository license does not grant rights to third-party assets or trademarks. See NOTICE.md.