Generate
Synopsis
Section titled “Synopsis”tman [options]tman generate [options]Both forms run the same generation pipeline. There are no positional arguments.
Options
Section titled “Options”| Flag | Behavior |
|---|---|
-c, --color <hex> | Optional seed color. Defaults to #6750A4. |
-p, --pick | Optional interactive Pastel picker source; requires pastel on PATH. |
-r, --random | Optional random Pastel color source. |
-l, --last | Optional last generated seed source from ~/.tg.json. |
-f, --favorite | Optional favorite seed source from ~/.tg.json. |
-t, --theme [name] | Optional included custom definition; omitting its name prompts. |
-a, --all | Generate every discoverable custom definition. |
-V, --variant <name> | Optional Material variant; prompts when omitted for seed-based generation. |
--save-fav | Save the last seed as a favorite instead of generating. |
--verbose | Print detailed diagnostics. |
Accepted variants are Content, Expressive, Fidelity, Fruit salad, Monochrome, Neutral, Rainbow, Tonal spot, and Vibrant.
Source rules and files
Section titled “Source rules and files”Source precedence is favorite > last > random > pick > provided. --all cannot be combined with a seed-source flag, and --theme cannot be combined with one. Without --all or --theme, more than one seed-source flag is an error.
Generation writes generated adapter sources and any adapter-owned extra files, and updates state in ~/.tg.json as the selected source flow requires. It does not apply live destinations. Each generation-capable adapter is isolated, so an adapter failure is reported without stopping later generators.
Examples
Section titled “Examples”tman generate --color "#6750A4" --variant "Tonal spot"tman --random --variant Vibranttman generate --theme tokyonight_nighttman generate --allInvalid hex input, absent last/favorites, unavailable picker, unknown custom themes, incompatible source flags, and invalid variants report an error and exit nonzero. A successful flow exits normally after the adapter pipeline completes.