Theme Pack Schema
A versioned manifest and documented tokens for palette, focal point, assets, compatibility, and licensing.
Open source foundation
The format, themes, validators, creator Skill, and local installation path are open for inspection and contribution. The hosted site is a free community Registry.
What is open
Advanced image themes depend on a local compatibility layer outside Codex's native color settings. Open implementation and restoration tools make that boundary visible.
A versioned manifest and documented tokens for palette, focal point, assets, compatibility, and licensing.
Checks that themes are complete, safe to distribute, and clear about platform and delivery paths.
macOS and Windows helpers designed around local state, explicit changes, and complete restoration.
Original templates with redistributable assets, illustrative layout previews, compatibility notes, and attribution records.
An optional Codex Skill for advanced creators who want to generate, inspect, and validate theme packs from source assets.
Regression checks for manifests, packages, installer safety, and the Codex versions the visual layer supports.
Repository map
The theme standard, CLI, safety runtime, website UI, and validated community Registry live together. Production secrets, resource IDs, and publisher data stay outside Git.
get-codex-theme/
├── apps/website/ gallery, publisher UI, validation APIs
├── packages/ schema, CLI, preview, installer core
├── platforms/ macOS and Windows adapters
├── themes/free/ original redistributable themes
├── plugins/ Codex plugin and creator/manager Skills
├── docs/ spec, security, compatibility
└── tests/ validation and regression coverageReference map
Use the native settings reference for Codex Desktop controls, the CLI reference for terminal themes, the Get Codex Theme guide for the boundary between them, and GitHub for the inspectable implementation.
Native desktop themes, colors, UI and code fonts, sharing, and visual-pack boundaries.
The current official reference for built-in desktop Appearance controls.
The current official reference for /theme and custom .tmTheme files.
Theme schema, CLI, free packs, safety runtime, tests, and restoration tooling.
For theme creators
The optional create-codex-theme Skill helps turn artwork into a validated pack. It is not required to browse, download, or install a theme.
Explore the Skill →For maintainers
Contributions should preserve signed application packages, bind visual services to loopback only, describe every local change, and include a complete restoration path.
Read contribution guidance →