azure-pipelines-cli

azure-pipelines-cli

A CLI tool for interacting with Azure Pipelines.

Requirements

• .NET 10+ SDK
• Authenticated via azd auth login (uses Azure Developer CLI credential)
• Run from within a Git repo whose remote points to Azure DevOps

Installation

Use dnx to run without global installation (like npx for Node):

dnx azp -y -- <command>

Important:

• Always use -y to skip the interactive confirmation prompt (which breaks LLM tool use).
• Always use -- to separate dnx options from tool arguments.

Workflows

Commands chain together in two natural flows. Each step's output feeds into the next.

Pipeline Development: list → info → check → run → wait

# 1. Discover pipelines in the current repo (shows name, ID, YAML path)
dnx azp -y -- list

# 2. Inspect a pipeline's variables and parameters
dnx azp -y -- info path/to/pipeline.yml

# 3. Validate YAML expansion with template parameters (dry run, no queue)
dnx azp -y -- check path/to/pipeline.yml --parameters env=staging

# 4. Queue the run with multiple parameters, variables, and stage skips
dnx azp -y -- run path/to/pipeline.yml --parameters env=staging,imageTag=latest --variables tag=v1,debug=true -s Deploy,Cleanup

# 5. Wait for completion using the build ID from step 4
dnx azp -y -- wait 12345 -f

check and run require a clean working tree synced with upstream — commit and push first.

Monitoring: status → logs

# 1. View run status as a tree (stages → jobs → tasks)
dnx azp -y -- status 12345 -d 3

# 2. Download logs for a specific task (logId shown in status -d 3 output)
dnx azp -y -- logs 12345 42

# Cancel a running build
dnx azp -y -- cancel 12345

status and logs also accept full Azure DevOps build URLs instead of numeric IDs.

Key Flags

Flag	Purpose	Commands
--parameters k=v[,k=v,...]	Template parameter overrides (comma-separated)	check, run
--variables k=v[,k=v,...]	Pipeline variable overrides (comma-separated; must be settable at queue time)	run
-s/--skip stage[,stage,...]	Stage names to skip (comma-separated)	run
-d 1|2|3	Tree depth: 1=stages, 2=+jobs (default), 3=+tasks	status
-f	Exit with non-zero code on failure/cancellation	wait

Command Reference

Command	Purpose
list	List all pipelines associated with the current repository
info <path>	Show pipeline details: variables, parameters, metadata
check <path>	Preview expanded YAML (dry run with template parameters)
run <path>	Queue a pipeline run with parameters, variables, and stage skips
status <id>	Show run status as a tree of stages, jobs, and tasks
cancel <id>	Cancel a running pipeline build
wait <id>	Poll until a run completes, with optional failure exit code
logs <id> <logId>	Download logs for a specific task from a run
llmstxt	Print comprehensive tool documentation
install-skill	Install the agent skill to a local or user directory

<path> is a relative path to the pipeline YAML file. <id> is a numeric build ID or a full Azure DevOps build results URL.

When to Use This Skill

• Listing and inspecting Azure Pipelines definitions in a repo
• Validating pipeline YAML before queuing a run
• Queuing pipeline runs with custom parameters and variables
• Monitoring build progress and downloading task logs
• Canceling in-progress pipeline runs