What is a codex-theme-v1 string?

It is the shareable theme payload used by the Codex desktop app. It includes the App theme colors, fonts, semantic colors, variant, and a base code-theme ID in one copyable string.

Why is the Import button disabled?

Check the codex-theme-v1 prefix, JSON syntax, six-digit hex colors, and codeThemeId. Some app versions have been reported to accept only code-theme IDs already available in their dropdown.

Can I use the same theme in the Codex App and CLI?

Not directly. The desktop App uses a codex-theme-v1 JSON string, while Codex CLI uses a TextMate .tmTheme file. You need a version of the theme in each format.

Guide

How to import and change a Codex theme

Codex App and Codex CLI use different theme formats. Choose your surface below, follow three steps, and apply a new look in a couple of minutes.

Pick a ready-made theme

Choose where you use Codex

The desktop App imports a JSON share string. The terminal CLI loads a TextMate theme file.

The desktop app imports a complete codex-theme-v1 string from Appearance settings. Copy a ready-made theme first, then follow these three steps.

Open Settings

Open the app menu and choose Settings.

Codex

GeneralAppearanceNotifications

SettingsSelect Appearance from the sidebar

Choose Appearance

Find the theme controls and select Import theme.

Codex

GeneralAppearanceNotifications

Appearance

Import theme

Paste and import

Paste the full string, import it, and check a code diff.

Codex

GeneralAppearanceNotifications

Import themecodex-theme-v1:{...}Import

Example: Nord theme for Codex App

codex-theme-v1:{"codeThemeId":"one","theme":{"accent":"#88c0d0","contrast":100,"fonts":{"code":null,"ui":null},"ink":"#d8dee9","opaqueWindows":true,"semanticColors":{"diffAdded":"#a3be8c","diffRemoved":"#bf616a","skill":"#b48ead"},"surface":"#2e3440"},"variant":"dark"}

Import button disabled?

Confirm that the value starts with codex-theme-v1:, contains valid JSON, uses six-digit hex colors, and does not include Markdown code fences. Some app versions also accept only a codeThemeId already listed in their code-theme dropdown.