Skip to content

mcpso/awesome-codex-themes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Awesome Codex Themes Awesome

A curated list of themes, skins, galleries, and theming tools for OpenAI Codex — the Codex CLI, the Codex desktop app, and the Codex IDE extension.

Codex theming happens on three surfaces:

  1. Codex CLI (terminal TUI) — 32 bundled syntax themes, switched with the /theme slash command (live preview) or tui.theme = "..." in ~/.codex/config.toml. Custom themes are standard TextMate .tmTheme files dropped into $CODEX_HOME/themes/ — thousands of existing Sublime Text / TextMate color schemes work out of the box.
  2. Codex desktop app — full appearance customization (base theme, accent/ink/surface colors, fonts, semantic diff colors) shipped in late March 2026. Themes travel as portable codex-theme-v1:{...} JSON strings, imported via Settings → Appearance → Dark/Light Theme → Import.
  3. Skins (CDP injection) — community tools inject CSS/artwork into the Codex desktop app at runtime over the local Chrome DevTools Protocol, enabling wallpaper-level customization far beyond color themes, without patching official binaries.

Contents

Official Resources

How Theming Works

CLI: .tmTheme + config.toml

# ~/.codex/config.toml
[tui]
theme = "catppuccin-mocha"   # any bundled name, or a custom .tmTheme in ~/.codex/themes/

Type /theme inside Codex for a live-preview picker that persists your choice. Custom themes are plain TextMate .tmTheme files: place my-theme.tmTheme in ~/.codex/themes/ and set theme = "my-theme" (the kebab-case filename becomes the theme name).

The CLI bundles 32 themes (defaults: catppuccin-mocha on dark terminals, catppuccin-latte on light):

Family Theme names
Catppuccin catppuccin-mocha · catppuccin-latte · catppuccin-frappe · catppuccin-macchiato
Base16 base16 · base16-256 · base16-eighties-dark · base16-mocha-dark · base16-ocean-dark · base16-ocean-light
Monokai Extended monokai-extended · monokai-extended-bright · monokai-extended-light · monokai-extended-origin
Gruvbox gruvbox-dark · gruvbox-light
Solarized solarized-dark · solarized-light
One / Two one-half-dark · one-half-light · two-dark
Coldark coldark-cold · coldark-dark
GitHub github · inspired-github
Classics dracula · nord · zenburn · sublime-snazzy · dark-neon · 1337 · ansi

App: codex-theme-v1 import strings

Desktop app themes are JSON payloads prefixed with codex-theme-v1:. Fields include codeThemeId, theme.accent, theme.ink (text), theme.surface (background), theme.contrast, theme.opaqueWindows, theme.fonts.{ui,code}, theme.semanticColors.{diffAdded,diffRemoved,skill}, and variant (dark/light). Import via Settings → Appearance → Dark/Light Theme → Import.

Gotcha: codeThemeId must match a built-in id (tokyo-night, one-dark, nord, dracula, catppuccin, gruvbox, solarized, github-light, matrix, one) — unknown ids fail silently (openai/codex#14766). Theme authors work around this by reusing a built-in id and overriding all colors.

The app ships built-in classics (Catppuccin, Monokai, Solarized) plus official partner themes including Linear, Notion, Raycast, and OpenClaw.

Codex CLI Themes

  • ychampion/codex-themes — Open-source theme manager for Codex CLI: validates community themes, previews in the terminal, installs .tmTheme files, writes reversible config.toml, ships status-line presets, and exports matching palettes for Windows Terminal, iTerm2, Ghostty, and Alacritty. MIT
  • Nick2bad4u/codex-terminal-themes — Gallery, installer, picker, and diagnostic CLI for 200+ TextMate themes packaged specifically for Codex terminal syntax highlighting. MIT
  • Any .tmTheme collection works too — e.g. the hundreds of schemes bundled with bat or from TextMate/Sublime theme galleries; drop the file into ~/.codex/themes/.

Codex App Themes

Galleries & Builders

  • DexThemes — Community site to discover and create Codex themes: searchable catalog, dark/light preview with accent controls, copyable import strings. By @daeshawn.

  • samuxbuilds/codex-themes — Interactive gallery of 1000+ themes with live preview and one-click export (live site): editor presets (Dracula, Nord, Tokyo Night, GitHub), brand palettes (Vercel, Stripe, Linear), color families, gradients, and accessibility/WCAG variants. MIT

    samuxbuilds codex-themes gallery
  • shaw-baobao/codex-themes — Curated Codex app themes with previews and ready-to-import strings; each theme ships theme.json + preview.svg + import.txt, with a JSON schema and build scripts. English/中文. MIT

    Codex Dark
    Codex Dark
    Tokyo Night
    Tokyo Night
    Catppuccin Mocha
    Catppuccin Mocha
    Dracula
    Dracula
    Nord
    Nord
    Rosé Pine
    Rosé Pine
  • lafllamme/codex-themes — TypeScript toolkit that converts raw terminal palettes (e.g. .itermcolors from iTerm2-Color-Schemes) into Codex-compatible JSON presets, with a browsable site. MIT

  • Railly/tinte — Agent-native design-system compiler and previewer with a Codex provider, useful for generating Codex themes alongside matching themes for other tools. MIT

  • meownoid/meowtheme — Multi-target color-scheme generator with ready-made light and dark Codex Desktop outputs. MIT

  • CosmicCoderDev/codex-themes — Small bilingual collection of desktop share strings with an interactive skin preview and light/dark Muse, Nebula, and Hacker variants. MIT

  • Kronosnxs/codex-theme-builder — Single-file web app for building and exporting custom Codex theme strings: tune light and dark variants, preview instantly, copy a ready-to-import string. MIT

    Codex theme builder web app
  • Utility Materials for Codex — Dark mineral surfaces with warm sand text; ships theme .json payloads plus paste-ready codex-theme-v1: import strings.

Individual Themes

Skins & Deep Customization

Community tools for decorative backgrounds, glass surfaces, theme switching, and deeper UI tweaks. Most use local CDP injection without modifying the signed app; entries that patch the local installation are separated and labeled below.

Discover a large collection of beautiful themes and skins for the Codex desktop app.

Explore CodexThemes →


Runtime CDP Skins

  • Fei-Away/Codex-Dream-Skin ⭐3.5k — External skins for the Codex desktop app; swap in any image as a full-window mood background while sidebar, cards, and input stay native. Ships 8 example skins, one-click restore, macOS + Windows installers. MIT

    Pink Custom
    Pink Custom
    God of Wealth
    God of Wealth
    Red-White Sci-Fi
    Red-White Sci-Fi
    Clear Custom
    Clear Custom
    Inspiration
    Inspiration
    Purple Night
    Purple Night
    Hatsune Miku
    Hatsune Miku
    Stage Black-Gold
    Stage Black-Gold
  • CodeDrobe/codex-skill ⭐88 — Open-source Codex theming Skill, AI theme generator, and cross-platform runtime for custom desktop themes; exports shareable .codex-theme files. Install with npx skills add anhao/codedrobe-codex-skill. macOS/Windows. Apache-2.0

    CodeDrobe desktop app
    CodeDrobe Desktop
    KUN Stage theme
    KUN Stage theme
  • HeiGeAi/heige-codex-skin-studio ⭐82 — One-click skin switcher for Codex Desktop: "one image = one theme," 9 presets (Hatsune Miku, Genshin Impact, Wuthering Waves, Naruto, Love & Deepspace) plus color extraction from any custom image. English/中文. MIT

    Miku theme with switcher menu
    Hatsune Miku + switcher
    Genshin starry night theme
    Genshin starry night
  • aiwenjie777/codex-skin-switcher ⭐18 — Codex skin manager (中文).

    codex-skin-switcher preview
  • tree0519/Codex-Dream-Skin-Forge — Dream Skin derivative with a Windows multi-theme pack, in-app switching, animated GIF skins, fixes, and AI-assisted theme creation. macOS/Windows.

  • xnydl/codex-dream-skin — Free macOS/Windows Dream Skin Skill with guided installation, switching, verification, and restoration.

  • aiwenjie777/codex-skin-skill — Agent-operated one-image skin installer for macOS and Windows, with theme switching and rollback.

  • Finderchangchang/codex-autoskin — Agent-native skin engine that extracts a palette from one image, writes an inspectable theme spec and manifest, then applies or restores it through CDP. Windows. MIT

  • fishcold789/Taffy-Codex-Theme-Studio — Taffy-inspired theme studio with replaceable images, 20 palettes, light/dark modes, acrylic, and liquid-glass styles. Windows.

  • ismoshushi/codex-skinkit — Switchable built-in and custom themes for Codex Desktop on Windows, including verification and restore commands. MIT

  • xiongwenhao112/raccoon-dream-skin — Agent Skill with six built-in office-raccoon themes, conversational switching, and one-click restoration. MIT

  • kongxcer555/codex-skin-builder — A Codex Skill for building and customizing Codex skins. MIT

    Cloud Crane Study skin
  • z0rgoyok/codex-theme-controller — macOS utility that applies color themes to Codex via the Chrome DevTools Protocol.

  • Alhamdulillah-R/cyberpunk-codex-skin — Cyberpunk/Edgerunners-flavored skin.

App Tweak Frameworks

  • b-nnett/codex-plusplus — Large cross-platform tweak system for Codex Desktop with UI modifications, extra settings surfaces, a native bridge, and a tweak SDK. Unlike the runtime-only skin tools above, it patches the local app installation; review its backup and restore workflow before use. MIT

Historical

  • jstxn/codex-themes — macOS launcher that ran Codex with an in-app theme button and 16 bundled themes (Ayu Mirage, Catppuccin, Dracula, Everforest, Flexoki, Gruvbox, Monokai Pro, Nightfox, Nord, Sonokai, TokyoNight Storm…), from before official theming support. Now deprecated by its author, but the minimal 4-field theme JSON remains a nice reference.

    jstxn codex-themes picker

Shared on X (Twitter)

Theme shares and theming moments worth knowing:

Machine-readable metadata for these posts lives in data/x-posts.json; see the data notes for collection rules.

Ports to Other Editors

Articles & Guides

Issues worth watching

  • openai/codex#14766 — Theme importer rejects custom codeThemeId values unless they match dropdown ids.
  • openai/codex#21130 — Request: configure semantic TUI colors beyond syntax highlighting.
  • openai/codex#1618 — The original "control over color theme in TUI" request (closed).

Contributing

Contributions welcome! Please read the contribution guidelines first, then open a pull request adding your theme or resource.

License

CC0

To the extent possible under law, the authors have waived all copyright and related or neighboring rights to this work.

Theme preview images under images/ are sourced from their respective upstream projects and remain the property of their authors; they are reproduced here for identification and preview purposes only.

Releases

Packages

Contributors