arrow run

Execute a pipeline defined in your project. This is the primary command for running workflows - it resolves dependencies, executes steps, and reports results.

Syntax

bash
arrow run [pipeline] [flags]

If no pipeline name is given, arrow runs the default pipeline defined in arrow.yaml.

Flags

Flag	Type	Default	Description
`--no-cache`	bool	`false`	Disable caching and re-run all steps
`--dry-run`	bool	`false`	Show what would run without executing
`--verbose`	bool	`false`	Show full command output for each step
`--timeout`	duration	`30m`	Maximum time before a pipeline is killed
`--env`	stringArray	`[]`	Set environment variables (KEY=VALUE)
`--only`	string		Run only a specific step by name

Examples

Run the default pipeline:

terminal

$ arrow run

(1/3) lint ....... done (0.6s)

(2/3) test ....... done (1.2s)

(3/3) build ...... done (2.1s)

Completed in 3.9s

Run a specific pipeline with environment variables:

bash
arrow run deploy --env NODE_ENV=production --env API_KEY=$API_KEY

Force a full re-run (skip cache):

bash
arrow run build --no-cache

Preview what would run:

terminal

$ arrow run build --dry-run

Pipeline: build (4 steps)

install (needs: none) [cached]

lint (needs: install) [cached]

test (needs: install) [cached]

build (needs: lint, test) [stale]

1 step will execute, 3 cached

Run a single step:

bash
arrow run build --only lint