Find Codex themes on CodexThemes

Search the published theme gallery on codexthemes.ai. This skill is standalone: its TypeScript scripts own the search request and API key storage. It does not create, install, or submit themes — codex-theme-creator, codex-theme-installer, and codex-theme-submitter own those jobs. The only required local tools are Node.js 20+ and npx.

Read references/search-api.md before diagnosing an unexpected API response or changing endpoint behavior. Run all commands from the installed skill directory.

Step 1: search

Turn the user's request into short search terms (style, subject, mood — for example dark anime, pastel floral light), then run:

npx tsx scripts/find-themes.ts <terms...> [--limit <1-50>] [--page <n>] [--sort <popular|newest|name>]

Searching works without any API key inside a free anonymous quota, so do not demand a key up front. When a key is already configured (CODEXTHEMES_API_KEY environment variable or ~/.codexthemes/credentials.json), the script sends it automatically for higher limits; the output's auth field shows which mode was used.

Run more than one search with different terms when the first result set is thin, but never loop on the same query.

Step 2: present the results