ciz run

ciz run consumes a compiled plan and either previews or executes it.

Usage

ciz run --plan plan.json

Without --execute, run stays in dry-run mode.

Common examples

Execute the full plan locally:

ciz run --plan plan.json --execute --runner local

Execute inside Docker:

ciz run --plan plan.json --execute --runner docker

Force GitHub Actions compatibility mode:

ciz run --plan plan.json --execute --gha

Retry one failed job after clearing its saved state:

ciz run --plan plan.json --execute --job-id web-app@staging.deploy --retry

Override the working directory for every job:

ciz run --plan plan.json --execute --workdir ./examples

Flags

Flag	Meaning
--plan, -p	Path to the compiled plan file
--execute, -x	Actually execute commands instead of dry-running
--workdir	Override the working directory for all jobs
--job-id	Run only one job ID
--retry	Clear saved state for the selected --job-id before running
--runner	Choose local, docker, or github-actions
--gha	Shortcut for --runner github-actions

Backend resolution

run chooses its backend in this order:

1. --gha
2. --runner
3. CIZ_RUNNER or LITECI_RUNNER
4. GITHUB_ACTIONS=true
5. Auto-detection when the plan contains a use: step
6. Default to local

State files

Executed plans record progress in the configured state file, usually .ciz-state.json. That allows resumable execution and job-level retries while protecting against plan checksum mismatches.