Skip to content

Generate

tman [options]
tman generate [options]

Both forms run the same generation pipeline. There are no positional arguments.

FlagBehavior
-c, --color <hex>Optional seed color. Defaults to #6750A4.
-p, --pickOptional interactive Pastel picker source; requires pastel on PATH.
-r, --randomOptional random Pastel color source.
-l, --lastOptional last generated seed source from ~/.tg.json.
-f, --favoriteOptional favorite seed source from ~/.tg.json.
-t, --theme [name]Optional included custom definition; omitting its name prompts.
-a, --allGenerate every discoverable custom definition.
-V, --variant <name>Optional Material variant; prompts when omitted for seed-based generation.
--save-favSave the last seed as a favorite instead of generating.
--verbosePrint detailed diagnostics.

Accepted variants are Content, Expressive, Fidelity, Fruit salad, Monochrome, Neutral, Rainbow, Tonal spot, and Vibrant.

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.

Terminal window
tman generate --color "#6750A4" --variant "Tonal spot"
tman --random --variant Vibrant
tman generate --theme tokyonight_night
tman generate --all

Invalid 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.