Codex theme import

Paste a real Codex theme import string first.

A `codex-theme-v1:` token is the lowest-friction way to test a Codex theme. It stays on the native Appearance surface for colors, contrast, and fonts. Use a downloadable skin pack only when you need background artwork, source files, and a manager restore path.

codex-theme-v1:{"codeThemeId":"absolutely","theme":{"accent":"#d96b42","contrast":60,"fonts":{"ui":"Avenir Next, SF Pro Text","code":"SF Mono"},"ink":"#35251c","opaqueWindows":true,"semanticColors":{"diffAdded":"#2f8f63","diffRemoved":"#c85a42","skill":"#b77b24"},"surface":"#fffdfa"},"variant":"light"}
Open appearance guideGitHub release txtDownload import txtDownload raw JSONDownload skin fallback
Native token

Import when you only need UI colors

Copy the token, open Codex Settings, choose Appearance, then use Import on the matching theme slot. This path does not install a wallpaper runtime and does not need private screenshots.

Tracked GitHub txtTracked .codex-theme-v1Tracked JSONPaste-ready .codex-theme.txt.codex-theme-v1 fileRaw theme JSON
codex-theme-v1:{"codeThemeId":"absolutely","theme":{"accent":"#d96b42","contrast":60,"fonts":{"ui":"Avenir Next, SF Pro Text","code":"SF Mono"},"ink":"#35251c","opaqueWindows":true,"semanticColors":{"diffAdded":"#2f8f63","diffRemoved":"#c85a42","skill":"#b77b24"},"surface":"#fffdfa"},"variant":"light"}
Agent prompt

Let Codex handle the import boundary

The prompt tells Codex to use native Appearance first, then fall back to the source-visible pack only if you need background artwork or a full Dream Skin workflow.

Help me import a Codex theme safely. Prefer the native Codex Settings / Appearance / Import flow for codex-theme-v1 tokens. Use the Caishen Readable Light token below first, explain that it changes colors and fonts only, then verify Home / Task / Diff / Composer readability. If I want a background skin afterwards, use $codex-skin-pack-installer and fetch caishen-readable with a restore path.
Skin fallback

Fetch Caishen Readable when native is not enough

Caishen Readable remains the safer first background pack because it has the clearest download signal, a softer palette, packaged files, and restore guidance.

npx skills add ChannelerH/codex-skin-packs --skill codex-skin-pack-installer --global --agent codex --yes
python3 "$CODEX_SKILL_DIR/scripts/fetch_skin_pack.py" caishen-readable
Import vs skin

Use the smallest change that solves the job.

Import strings are best for quick native themes. Skin packs are for image backgrounds, public artwork, `theme.json`, README notes, and manager workflows. Both paths should end with a restore check.