Skip to content

workflow run

Trigger any workflow_dispatch GitHub Actions workflow on any project — not just the configured deploy workflow.

Usage

subscribed workflow run                              # fully interactive
subscribed workflow run <project>                    # skip project selection
subscribed workflow run <project> <workflow-file>    # skip workflow selection
subscribed workflow run <project> <workflow-file> --ref <branch>

Flow

When arguments are omitted, the CLI prompts interactively:

  1. Project — select from the registered project list
  2. Workflow — fetched live from GitHub; shows all workflows in the repo
  3. Branch — fetched live from GitHub

Difference from deploy

deploy workflow run
Workflow Fixed per project (deployWorkflow) Any workflow in the repo
Environment input Yes No
Production guardrail Yes No
Use case Standard deploys One-off jobs, releases, maintenance tasks

Requirements

  • subscribed auth login must have been run with a token that has repo and workflow scopes
  • The target workflow must have workflow_dispatch enabled