CLI Reference

Run a workflow

promd <step> [step2 ...]

A step can be a file name, a directory, or a comma-separated list of files to combine into a single step.

Examples:

promd weather
promd weather plan-activities
promd .
promd file1,file2 file3

Options

• -v, --verbose: print extra logs (config loading, steps)
• -b, --backend <name>: backend override (opencode, subprocess, mock)
• --count <number> and --exitOn <condition>: loop controls (only applied when --count is set)

Custom variables

Any unknown --key value flags are treated as variables.

promd weather --city Berlin --units metric

Use them as {{city}} and {{units}} in prompt files.

Loop command

promd loop --count <n> [--exitOn "text"] <step> [step2 ...]

Example:

promd loop --count 5 --exitOn "DONE" step-1 step-2