Labsco
github logo

azure-devops-cli

โœ“ Officialโ˜… 36,202

by github ยท part of github/awesome-copilot

Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeNeeds API keys
๐Ÿงฉ One of 7 skills in the github/awesome-copilot package โ€” works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates โ€” you don't need to read it to use the skill, but it's here to audit before installing.

Azure DevOps CLI

Manage Azure DevOps resources using the Azure CLI with the Azure DevOps extension.

CLI Version: 2.81.0 (current as of 2025)

Authentication

# Login with PAT token
az devops login --organization https://dev.azure.com/{org} --token YOUR_PAT_TOKEN

# Set default organization and project (avoids repeating --org/--project)
# Note: Legacy URL https://{org}.visualstudio.com should be replaced with https://dev.azure.com/{org}
az devops configure --defaults organization=https://dev.azure.com/{org} project={project}

# List current configuration
az devops configure --list

CLI Structure

az devops          # Main DevOps commands
โ”œโ”€โ”€ admin          # Administration (banner)
โ”œโ”€โ”€ extension      # Extension management
โ”œโ”€โ”€ project        # Team projects
โ”œโ”€โ”€ security       # Security operations
โ”‚   โ”œโ”€โ”€ group      # Security groups
โ”‚   โ””โ”€โ”€ permission # Security permissions
โ”œโ”€โ”€ service-endpoint # Service connections
โ”œโ”€โ”€ team           # Teams
โ”œโ”€โ”€ user           # Users
โ”œโ”€โ”€ wiki           # Wikis
โ”œโ”€โ”€ configure      # Set defaults
โ”œโ”€โ”€ invoke         # Invoke REST API
โ”œโ”€โ”€ login          # Authenticate
โ””โ”€โ”€ logout         # Clear credentials

az pipelines       # Azure Pipelines
โ”œโ”€โ”€ agent          # Agents
โ”œโ”€โ”€ build          # Builds
โ”œโ”€โ”€ folder         # Pipeline folders
โ”œโ”€โ”€ pool           # Agent pools
โ”œโ”€โ”€ queue          # Agent queues
โ”œโ”€โ”€ release        # Releases
โ”œโ”€โ”€ runs           # Pipeline runs
โ”œโ”€โ”€ variable       # Pipeline variables
โ””โ”€โ”€ variable-group # Variable groups

az boards          # Azure Boards
โ”œโ”€โ”€ area           # Area paths
โ”œโ”€โ”€ iteration      # Iterations
โ””โ”€โ”€ work-item      # Work items

az repos           # Azure Repos
โ”œโ”€โ”€ import         # Git imports
โ”œโ”€โ”€ policy         # Branch policies
โ”œโ”€โ”€ pr             # Pull requests
โ””โ”€โ”€ ref            # Git references

az artifacts       # Azure Artifacts
โ””โ”€โ”€ universal      # Universal Packages

Reference Files

Read the relevant reference file based on the user's task. Each file contains complete command syntax and examples for its domain.

FileWhen to readCovers
references/repos-and-prs.mdRepos, branches, pull requests, branch policiesRepositories, Import, PRs (create/list/vote/reviewers/policies), Git refs, Branch policies
references/pipelines-and-builds.mdPipelines, builds, releases, artifactsPipelines CRUD, runs, builds, releases, artifacts download/upload
references/boards-and-iterations.mdWork items, sprints, area pathsWork items (WIQL/create/update/relations), Area paths, Iterations, Team iterations
references/variables-and-agents.mdPipeline variables, agent poolsPipeline variables, Variable groups, Pipeline folders, Agent pools/queues
references/org-and-security.mdProjects, teams, users, permissions, wikisProjects, Extensions, Teams, Users, Security groups/permissions, Service endpoints, Wikis, Admin
references/advanced-usage.mdOutput formatting, JMESPath queriesOutput formats, JMESPath queries (basic + advanced), Global args, Common params, Git aliases
references/workflows-and-patterns.mdAutomation scripts, best practices, error handlingCommon workflows, Best practices, Error handling, Scripting patterns, Real-world examples
references/long-comments-on-windows.mdLong --discussion, --description, or --content values failing on WindowsThe cmd.exe 8191 char cap on az.cmd, shell detection, and three verified workarounds (azps.ps1, native --file-path, az devops invoke --in-file)