Skip to content

Run tasks

Run xdrun from the project directory followed by a task name:

xdrun hello

If you used minimal initialization, the generated task is named default:

xdrun default

List available tasks

xdrun --list

Pass parameters

Task parameters use key=value syntax:

xdrun deploy environment=production version=v1.2.3

CLI behavior uses flags. For example, preview a task without executing it:

xdrun deploy environment=production --dry-run

Run a specific spec

xdrun discovers .drun/spec.drun and other conventional locations automatically. Use --file when you need to select a particular spec:

xdrun --file examples/01-hello-world.drun hello

Next, learn how project templates can generate useful boilerplate for your stack.