src run trigger

Trigger a specific CI workflow by name with optional input parameters.

The workflow will run on the current branch/HEAD by default, or you can specify
a different commit, branch (ref), or tag to run on.

You can also specify where to read the CI configuration from using the --cfg-*
flags. This is useful for testing experimental CI configurations.

Usage

src run trigger <workflow_name> [param=value ...] [flags]

Examples

Trigger pytest workflow on current branch

src run trigger pytest

Trigger with parameters

src run trigger pytest param=value param2=value2

Trigger on a specific commit

src run trigger pytest --commit abc1234

Trigger on a specific branch

src run trigger pytest --ref mybranch

Trigger on a specific tag

src run trigger pytest --tag v1.0.0

Use config from a specific commit

src run trigger pytest --cfg-commit abc1234

Use config from an experimental branch

src run trigger pytest --cfg-ref myexperimental-cicd

Use config from a specific tag

src run trigger pytest --cfg-tag v1.0.0

Combine: run on tag with config from experimental branch

src run trigger pytest --tag v1.0.0 --cfg-ref experimental-ci

Flags

Flag	Description
--commit string	Run workflow on specific commit
--ref string	Run workflow on specific branch
--tag string	Run workflow on specific tag
--cfg-commit string	Read CI config from specific commit
--cfg-ref string	Read CI config from specific branch
--cfg-tag string	Read CI config from specific tag
--shared	Run shared workflows (for users without repository access)
-w, --web	Open the triggered run in browser

Inherited flags

Flag	Description
--env string	Override Sourcecraft environment (use 'src envs' to list available)
--json string	Output JSON, optionally filtered (--json or --json=field1,field2)
--json-compact string	Output compact JSON, optionally filtered
--plain	Output without colors/styling (for LLM consumption)
-R, --repo string	Select another repository using OWNER/REPO format
-V, --verbose	Enable debug logging output

Learn more

Use src run trigger <subcommand> --help for more information about a command.