Switch the active Codex theme

Apply a theme from the managed local library ~/.codexthemes/themes/<theme-id>/ to the running Codex desktop app, switch between installed themes, restore the native look, and verify what is actually active. This skill is standalone: its TypeScript scripts own the reversible injection runtime. It does not create or edit themes (codex-theme-creator), install them from the gallery (codex-theme-installer), or publish them (codex-theme-submitter). The only required local tools are Node.js 20+, npx, and the official Codex desktop app.

Run all commands from the installed skill directory. The runtime injects only an owned <style> element over Codex's loopback-only debugging endpoint; it never modifies the signed app bundle, and it themes every open Codex page, not just one window.

Step 1: pick the theme

npx tsx scripts/switch-theme.ts list

Lists every installed theme (id, name, layout mode) and which one is currently active. Themes arrive in the library from codex-theme-creator (created locally) or codex-theme-installer (downloaded from codexthemes.ai). If the theme the user wants is not listed, hand off to those skills instead of guessing paths.

Step 2: apply or switch

npx tsx scripts/switch-theme.ts apply <theme-id>