Skip to main content
The run command runs one or more tasks from the playbook files in the target directory.

​
Usage

If no task names are given, Errand runs the task named default.

​
Arguments

​
tasks
string[]
One or more task names to run. Each name must match a task block declared in the playbook. Errand resolves all required tasks in the correct order.

​
Flags

​
--var, -v
name=value
Set a variable value. Repeat the flag to set multiple variables.
​
--concurrency, -c
number
default:"1"
Maximum number of tasks to run at the same time.
  • 1 (default) runs tasks sequentially.
  • Any positive number limits concurrent execution to that count.
  • 0 runs all independent tasks at the same time with no limit.
​
--echo, -e
bool
default:"true"
Print each command before running it. Set to false to suppress command output:
​
--exit-code, -x
bool
default:"false"
Forward the exit code of failed tasks. When enabled, errand run exits with the same code as the first failed task. By default it exits with 1 for any failure.
​
--dir, -d
path
default:"."
Directory containing the playbook files. Defaults to the current directory.

​
Examples

Run the default task:
Run a specific task:
Run multiple tasks:
Run with concurrency and a variable:
Run tasks from a different directory:

​
Exit codes