Running GitHub Actions Workflow from Terminal

Trigger workflow from a feature branch

gh workflow run "Publish beta package (TEST)" \
  --repo Launchmetrics/GIS-shared \
  --ref m-fix-beta-package-workflow \
  --field pr-number=332 \
  --field targets=GIS-mekong:m-feature-test-new

Parameters:

• --ref: The branch containing the workflow file to run
• --field pr-number: The PR number to publish packages from
• --field targets: Target repos in format repo:branch (comma-separated for multiple)

List recent workflow runs

gh run list --repo Launchmetrics/GIS-shared --workflow="Publish beta package (TEST)" --limit 5

Watch a workflow run in real-time

gh run watch <run-id> --repo Launchmetrics/GIS-shared

View workflow run status

gh run view <run-id> --repo Launchmetrics/GIS-shared

View logs for a specific job

gh run view <run-id> --repo Launchmetrics/GIS-shared --job=<job-id>

View full logs

gh run view <run-id> --repo Launchmetrics/GIS-shared --log

Example: Full workflow

# 1. Trigger the workflow
gh workflow run "Publish beta package (TEST)" \
  --repo Launchmetrics/GIS-shared \
  --ref m-fix-beta-package-workflow \
  --field pr-number=332 \
  --field targets=GIS-mekong:m-feature-branch

# 2. Get the run ID
gh run list --repo Launchmetrics/GIS-shared --workflow="Publish beta package (TEST)" --limit 1

# 3. Watch it run
gh run watch <run-id> --repo Launchmetrics/GIS-shared