gitlink-cli/skills/gitlink-pipeline/SKILL.md

name	version	description	metadata
gitlink-pipeline	1.0.0	Pipeline workflow operations: list pipelines, run workflows, inspect runs, fetch logs, save visual YAML, enable, disable, and delete pipelines.	requires cliHelp bins gitlink-cli gitlink-cli pipeline --help

gitlink-pipeline

Read ../gitlink-shared/SKILL.md first for authentication, global flags, and API behavior.

CRITICAL: confirm user intent before running write or delete commands. Prefer --dry-run before pipeline +run, pipeline +save-yaml, pipeline +enable, pipeline +disable, or pipeline +delete.

Shortcuts

Shortcut	Description
pipeline +list	List platform pipelines
pipeline +runs	List repository pipeline run records
pipeline +run	Start a pipeline workflow
pipeline +view	Show pipeline details
pipeline +delete	Delete a pipeline
pipeline +save-yaml	Save a visual pipeline YAML graph
pipeline +enable	Enable a pipeline workflow
pipeline +disable	Disable a pipeline workflow
pipeline +logs	Query pipeline run logs
pipeline +results	Show pipeline run report results

Examples

# List platform pipelines
gitlink-cli pipeline +list --owner-id 123 --page 1 --limit 20

# List and run workflow records for a repository
gitlink-cli pipeline +runs --owner Gitlink --repo forgeplus --ref master --workflow build.yml
gitlink-cli pipeline +run --owner Gitlink --repo forgeplus --ref master --workflow build.yml --dry-run

# Inspect a pipeline and its logs
gitlink-cli pipeline +view --owner Gitlink --repo forgeplus --id 7
gitlink-cli pipeline +logs --owner Gitlink --repo forgeplus --run-id 99 --id 7 --index 43
gitlink-cli pipeline +results --owner Gitlink --repo forgeplus --run-id 99

# Save a visual pipeline graph
gitlink-cli pipeline +save-yaml --owner Gitlink --repo forgeplus \
  --id 7 --pipeline-json '{"nodes":[]}' --dry-run

# Toggle or delete pipeline workflows
gitlink-cli pipeline +enable --owner Gitlink --repo forgeplus --id 7 --workflow build.yml --dry-run
gitlink-cli pipeline +disable --owner Gitlink --repo forgeplus --id 7 --workflow build.yml --dry-run
gitlink-cli pipeline +delete --owner Gitlink --repo forgeplus --id 7 --dry-run

API Mapping

Shortcut	Method	API path
pipeline +list	GET	/api/pm/pipelines.json
pipeline +runs	GET	/api/v1/{owner}/{repo}/actions/runs.json
pipeline +run	POST	/api/v1/{owner}/{repo}/actions/runs.json
pipeline +view	GET	/api/v1/{owner}/{repo}/pipelines/{id}.json
pipeline +delete	DELETE	/api/v1/{owner}/{repo}/pipelines/{id}.json
pipeline +save-yaml	POST	/api/v1/{owner}/{repo}/pipelines/save_yaml
pipeline +enable	POST	/api/v1/{owner}/{repo}/actions/enable.json
pipeline +disable	POST	/api/v1/{owner}/{repo}/actions/disable.json
pipeline +logs	POST	/api/v1/{owner}/{repo}/actions/runs/{run_id}/jobs/0
pipeline +results	GET	/api/v1/{owner}/{repo}/pipelines/run_results.json