CodexThemes
Submit

Documentation

Agent-powered workflows cover the whole theme lifecycle — from creating and submitting to finding, installing, switching, and restoring. Copy a prompt, paste it into your AI agent, and it handles the rest through the official CodexThemes skills from SKILL.md.

Create a theme

Turn a reference image or a written brief into a complete Codex desktop theme with the codex-theme-creator skill.

  1. Open your AI agent (Claude Code, Codex CLI, or any agent that can read URLs and run commands).
  2. Copy the prompt below, then attach a reference image or replace the bracketed brief with the mood, colors, and subject you want.
  3. The agent bootstraps codex-theme-creator from SKILL.md and builds the theme source and previews under ~/.codexthemes/themes/<theme-id>/.
  4. Review the previews. The agent always asks for permission before applying the theme or restarting Codex.
  5. The shareable package is exported to ~/.codexthemes/exports/<theme-id>.codex-theme — ready to submit.
Paste into your agent
Use $codex-theme-creator from https://codexthemes.ai/SKILL.md to create a Codex desktop theme from my attached reference image or this brief: [describe the mood, colors, and subject].

Submit a theme

Publish your exported theme to the CodexThemes gallery with codex-theme-submitter.

  1. Create a CodexThemes API key at codexthemes.ai/settings/apikeys — agent submissions always require one.
  2. Export your theme as a .codex-theme package (the creator skill does this automatically).
  3. Copy the prompt below. The agent validates the package with a dry run and submits it through the API.
  4. The theme publishes immediately and the agent reports its detail-page link. Resubmitting the same theme updates it in place.
Paste into your agent
Use $codex-theme-submitter from https://codexthemes.ai/SKILL.md to submit my theme to codexthemes.ai.

Prefer a form? You can also upload the package manually at codexthemes.ai/submit.

Find themes

Search the published gallery by style, subject, or mood with the codex-theme-finder skill.

  1. Copy the prompt below and replace the bracketed keywords with what you are looking for.
  2. The agent searches the gallery API and presents up to five candidates with previews and detail-page links.
  3. Pick one — installable themes hand off to the installer, and design-only skins can be recreated with the creator skill.
Paste into your agent
Use $codex-theme-finder from https://codexthemes.ai/SKILL.md to search codexthemes.ai for [style, subject, mood].

Install a theme

Install any .codex-theme package from the gallery with codex-theme-installer, then apply it with codex-theme-switcher.

  1. Note the theme id — it is shown on every theme's detail page (for example shaolin-football).
  2. Copy the prompt below with the theme id filled in.
  3. The agent downloads the package and unpacks it into ~/.codexthemes/themes/<theme-id>/.
  4. The switcher applies it — hot-swapping when possible, and always asking before restarting Codex.
Paste into your agent
Use $codex-theme-installer from https://codexthemes.ai/SKILL.md to install the theme "[theme id]" from codexthemes.ai, then use $codex-theme-switcher to apply it.

Themes published as .zip archives are not agent-installable — sign in and download them from the theme's detail page instead.

Switch themes

Apply, swap, or re-apply any locally installed theme with the codex-theme-switcher skill.

  1. Copy the prompt below with the theme id filled in — the switcher lists everything installed under ~/.codexthemes/themes/.
  2. It hot-swaps the running app when Codex exposes its debugging endpoint, and otherwise asks for your permission before restarting Codex.
  3. It verifies the result against the real DOM with its status command — the agent never claims success until the theme is actually active.
Paste into your agent
Use $codex-theme-switcher from https://codexthemes.ai/SKILL.md to switch my Codex theme to [theme id], or to apply the theme I just created or installed.

Restore the native look

Themes are session-level style injection — no application files are ever modified, so recovery is always one step away. Three ways, fastest first.

  1. No agent needed: fully quit Codex (Cmd+Q, not just closing the window) and reopen it. A clean restart always brings back the native look.
  2. With your agent, no restart: copy the prompt below — it removes the injected styles and markers from every open page immediately.
  3. Or just switch: applying another theme id hot-swaps directly — no restore needed first.
Paste into your agent
Use $codex-theme-switcher from https://codexthemes.ai/SKILL.md to restore my native Codex look.

If an old theme comes back after a restore, a stale session is re-injecting it — ask your agent to force a clean relaunch, or fully quit Codex and reopen.