Skip to content

keryx theme

Manage the theme catalog — keryx's config-driven aesthetic profiles (palette, image-prompt styles, music tone, voice). Themes live in config, never in code; see the Themes concept and design spec §6.

keryx theme list  [--type <article|reel|portrait>]
keryx theme show  <keyword> [--type <t>]
keryx theme add   <keyword>  --type <t> [--from <keyword>] [--set key=value ...]
keryx theme edit  <keyword> [--type <t>]  --set key=value ...
keryx theme rm    <keyword> [--type <t>]
Flag Subcommands Meaning
--type all the theme type. Required for add; elsewhere it disambiguates a keyword present under more than one type.
--from add clone an existing theme of the same type as a starting point.
--set add, edit set a dotted field, repeatable; values coerce to bool/int/float when unambiguous (e.g. voice.stability=0.74, palette.amber=#E8923B, card.mode=block).

Add --output json for machine-readable output (R-GLOBAL-3).

Examples

keryx theme list                 # whole catalog, grouped by type (* marks each default)
keryx theme list --type reel
keryx theme show editorial --type reel
keryx theme add editorial-steady --type reel --from editorial --set voice.stability=0.74
keryx theme edit clay --type reel --set music.gain=0.18
keryx theme rm editorial-steady --type reel

Behaviour & contracts

  • list groups by type and marks the per-type default — R-THEME-1.
  • add creates/clones and persists via the GTB config layer; keywords are unique within a type — R-THEME-2, R-THEME-3.
  • edit round-trips (--set then show reflects it) — R-THEME-4.
  • rm refuses to delete a theme that is its type's default — R-THEME-5.
  • Writes go to the active config file (keryx init); secrets are never written there — R-CFG-2.

See also

  • Themes concept — the model, types, and seeded house set.
  • keryx init — seeds the house themes.