CLI Reference

The malarky CLI is available after installation. If installed locally, use npx malarky or npm run cli -- <args>.

malarky <command> [options]

Commands

Command Description
sentence Generate one or more sentences
paragraph Generate one or more paragraphs
text Generate a text block (multiple paragraphs)
validate Validate a lexicon JSON file
list List available transforms or sentence types

Global options

These options work with sentence, paragraph, and text:

Option Short Description
--seed <n> -s RNG seed for deterministic output
--lexicon <path> -l Path to a lexicon JSON file
--archetype <name> -a Archetype to activate from the lexicon
--transform <id> -x Apply an output transform (repeatable, comma-separated)
--trace -t Output JSON trace to stderr
--json -j Output full result as JSON to stdout
--count <n> -n Number of items to generate (default: 1)
--help -h Show help
--version -v Show version

Table of contents


Back to top

Malarky © 2026. Distributed under the MIT License.

This site uses Just the Docs, a documentation theme for Jekyll.