Skip to content
ThemeCC

Submit a theme

Themes are added through a pull request to the ThemeCC repository. There is no account and no form.

Open the repository

Steps

  1. Fork the repository and create a folder under registry/desktop or registry/cli, named with your theme's slug.
  2. Add the files described below.
  3. Run pnpm registry:check locally. It runs the same checks as the pull request.
  4. Open a pull request. CI validates the entry. A maintainer merges CLI themes after checks pass and reviews desktop mods by hand.

Desktop themes (mods)

Your theme stays in your own repository. The entry points to it with a full commit hash. To update it, open a new pull request with the new hash.

registry/desktop/<slug>/theme.json, poster.webp (up to 300 KB), preview.mp4 (optional, up to 8 MB and 15 seconds)

Rules

  • The repository must be public and have an accepted license.
  • The plugin name must equal the slug.
  • The plugin must pass claude plugin validate.
  • No obfuscated or minified code. Declare network, file, and command use honestly.
  • You must own the preview artwork or have permission to use it.
  • Do not add a reviewed field. The maintainer adds it after reading the source at the pinned commit.

Example theme.json for a desktop theme

{
  "name": "Night Sky",
  "description": {
    "en": "A dark palette with a slow starfield behind the conversation.",
    "zh": "深色配色,对话后方有缓慢移动的星空。"
  },
  "usage": {
    "en": "Start a new local session in the Code tab. Run /night-sky off to remove it."
  },
  "author": { "github": "your-github-name" },
  "license": "MIT",
  "source": {
    "repo": "your-github-name/night-sky",
    "sha": "0123456789abcdef0123456789abcdef01234567"
  },
  "plugin": "night-sky",
  "minClaudeCode": "2.1.324",
  "colorScheme": ["dark"],
  "motion": true,
  "tags": ["space", "dark"],
  "permissions": { "network": false, "files": false, "commands": false },
  "preview": { "poster": "poster.webp", "video": "preview.mp4" },
  "addedAt": "2026-01-01"
}

CLI themes

The theme file uses the official Claude Code format, so it works if you copy it to ~/.claude/themes.

registry/cli/<slug>/theme.json and meta.json

Rules

  • theme.json has name, base, and overrides. Colors use #rrggbb, #rgb, rgb(), ansi256(), or ansi:name.
  • meta.json states the author and an accepted license. Ports of existing palettes must name the upstream project and keep its copyright notice.
  • A description written in your own words.

Accepted licenses

MIT, Apache-2.0, BSD-2-Clause, BSD-3-Clause, ISC, CC0-1.0. Entries without a clear license are not listed.

How review works

CLI themes only contain color values, so they are merged after the automated checks pass. Desktop mods can read files, make requests, and run commands, so a maintainer reads the source at the pinned commit and records the result in the entry. Entries without that record are shown as not yet reviewed.

Removal

Authors can ask for an entry to be removed at any time by opening an issue or a pull request.