azp 0.5.0
dotnet tool install --global azp --version 0.5.0
dotnet new tool-manifest
dotnet tool install --local azp --version 0.5.0
#tool dotnet:?package=azp&version=0.5.0
nuke :add-package azp --version 0.5.0
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
- Authenticated via
azd auth login - Run from within a Git repo whose remote points to Azure DevOps
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.
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
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.