The zorto command-line interface. See installation for setup, live reload for preview server details, and troubleshooting for common issues.

zorto #

zorto --help

The AI-native static site generator (SSG) with executable code blocks

Usage: zorto [OPTIONS] [COMMAND]

Commands:
  build    Build the site
  preview  Start preview server with live reload
  clean    Remove output directory and/or cache
  init     Initialize a new site
  check    Check site for errors without building
  skill    Install zorto skill files for AI agents
  help     Print this message or the help of the given subcommand(s)

Options:
  -r, --root <ROOT>        Site root directory [default: .]
  -N, --no-exec            Disable execution of code blocks ({python}, {bash}, {sh})
      --sandbox <SANDBOX>  Sandbox boundary for file operations (include shortcode, etc.). Paths cannot escape this directory. Defaults to --root
  -h, --help               Print help
  -V, --version            Print version

zorto build #

zorto build --help

Build the site

Usage: zorto build [OPTIONS]

Options:
  -o, --output <OUTPUT>      Output directory [default: public]
      --drafts               Include draft pages
      --base-url <BASE_URL>  Base URL override
  -h, --help                 Print help

zorto preview #

zorto preview --help

Start preview server with live reload

Usage: zorto preview [OPTIONS]

Options:
  -o, --output <OUTPUT>        Output directory [default: public]
  -p, --port <PORT>            Port number [default: 1111]
      --drafts                 Include draft pages
  -O, --open                   Open browser
      --interface <INTERFACE>  Bind address [default: 127.0.0.1]
  -h, --help                   Print help

zorto init #

zorto init --help

Initialize a new site

Usage: zorto init [OPTIONS] [NAME]

Arguments:
  [NAME]  Site directory name (defaults to current --root)

Options:
  -t, --template <TEMPLATE>  Template to use (default, blog, docs, business) [default: default]
  -h, --help                 Print help

zorto check #

zorto check --help

Check site for errors without building

Usage: zorto check [OPTIONS]

Options:
      --drafts         Include draft pages
      --deny-warnings  Treat lint warnings as errors
  -h, --help           Print help

zorto clean #

zorto clean --help

Remove output directory and/or cache

Usage: zorto clean [OPTIONS]

Options:
  -o, --output <OUTPUT>  Output directory to remove [default: public]
      --cache            Also clear the code block execution cache (.zorto/cache/)
  -h, --help             Print help