Skip to content
chant

chant run

Synopsis

Section titled “Synopsis”
chant run <name> [flags]
chant run list [flags]
chant run status <name> [flags]
chant run signal <name> <signal> [flags]
chant run cancel <name> [flags]
chant run log <name> [flags]

Description

Section titled “Description”

chant run starts and manages Op workflows — named, phased Temporal workflows defined in *.op.ts files. Running an Op spawns a Temporal worker process and submits the workflow. Requires @intentius/chant-lexicon-temporal and a reachable Temporal server.

Connection settings come from chant.config.ts under temporal.profiles. See Worker Profiles for configuration.

Subcommands

Section titled “Subcommands”

run <name>

Section titled “run <name>”

Start an Op: spawns the compiled worker for that Op and submits the workflow to Temporal. Polls status every 3 seconds until the workflow completes or fails.

Terminal window
chant run alb-deploy
chant run alb-deploy --profile cloud
chant run alb-deploy --report   # print deployment report instead of running

run list

Section titled “run list”

List all discovered Ops (*.op.ts files) with their current Temporal run status.

Terminal window
chant run list

Output columns: NAME, PHASES, TASK-QUEUE, DEPENDS, OVERVIEW, STATUS.

run status <name>

Section titled “run status <name>”

Show the current state of an Op’s latest workflow run.

Terminal window
chant run status alb-deploy

run signal <name> <signal>

Section titled “run signal <name> <signal>”

Send a named signal to unblock a gate step in a running workflow.

Terminal window
chant run signal alb-deploy gate-dns-delegation

The signal name must match the signalName passed to the gate() builder in the Op definition.

run cancel <name>

Section titled “run cancel <name>”

Cancel the active workflow run. Requires --force.

Terminal window
chant run cancel alb-deploy --force

run log <name>

Section titled “run log <name>”

Show run history for an Op.

Terminal window
chant run log alb-deploy

Flags

Section titled “Flags”
FlagDescription
-p, --profile <name>Temporal worker profile to use (from chant.config.ts)
--reportPrint a deployment report instead of running (run <name> only)
--forceRequired for run cancel

Exit Codes

Section titled “Exit Codes”
CodeMeaning
0Success (workflow completed or command succeeded)
1Error (workflow failed, Op not found, Temporal unreachable)

See Also

Section titled “See Also”