azp - Azure Pipelines Tool

A CLI for interacting with Azure Pipelines from the terminal.

Quick Start

Install the tool globally:

dotnet tool install -g azp

Install agent skill (interactive):

dnx azp -y -- install-skill

Requirements

• .NET 10+ SDK
• Azure Developer CLI
• Authenticate with azd auth login

Quick Reference

Command	Purpose
azp list	List all pipelines in the current repository
azp info <path>	Show pipeline details: variables, parameters, metadata
azp check <path>	Preview expanded YAML (dry run with template parameters)
azp run <path>	Queue a pipeline run with parameters, variables, and stage skips
azp status <id>	Show run status as a tree of stages, jobs, and tasks
azp cancel <id>	Cancel a running pipeline build
azp wait <id>	Poll until a run completes, with optional failure exit code
azp logs <id> <logId>	Download logs for a specific task from a run
azp llmstxt	Print comprehensive tool documentation
azp 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.

Note

Commands requiring the path argument require you to run azp from within a Git repo that has a remote pointing to Azure DevOps. azp uses your git remotes to infer Azure DevOps organization, project, and repo context to find pipelines associated with your repo.

Usage

Commands chain together in natural workflows.

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

# Discover pipelines in the current repo
azp list

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

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

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

# Wait for completion using the build ID from the previous step
azp wait 12345 -f

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

Monitoring: status → logs

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

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

# Cancel a running build
azp cancel 12345

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

Agent Skill

This repo includes a skill which shows AI coding assistants how to use azp to develop Azure Pipelines on your behalf. With the azure-pipelines-tool skill, agents can check pipeline syntax, queue pipeline runs, investigate failing pipelines, and even wait for runs to complete and react accordingly.

Easy install with azp install-skill

dnx azp -y -- install-skill

The interactive installer lets you choose the target agent (GitHub Copilot, Claude Code, Gemini, or agent-agnostic) and whether to install locally or to your user directory.

Install via plugin marketplace

GitHub Copilot CLI (Recommended)

/plugin marketplace add lbussell/AzurePipelinesTool

/plugin install azure-pipelines-tool@lbussell-azure-pipelines-tools

The plugin marketplace is also compatible with Claude Code.

Development

See docs/development/ for build, test, and publishing instructions.

License

MIT