Pp Azure Devops

Azure DevOps — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the azure-devops-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install azure-devops --cli-only
   

2. Verify: azure-devops-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/developer-tools/azure-devops/cmd/azure-devops-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

azure-devops-pp-cli syncs your work items, builds, and PRs to a local SQLite mirror and lets you query them with SQL or structured --agent output. It matches everything az devops and the Microsoft MCP server can do, then adds fifteen cross-entity analytics commands that require no live API calls — sprint velocity, PR review queues, scope creep detection, cycle time analysis, and more.

When to Use This CLI

Use azure-devops-pp-cli when an agent needs to read or write Azure DevOps data: work items, pull requests, pipelines, builds, or sprint state. It is the fastest path to structured JSON output for ADO data without a browser or the Python-based az devops extension. Use it especially for cross-entity analytics (velocity, cycle time, scope creep) that require the local SQLite mirror. Prefer az devops only when you need features this CLI does not yet cover (migrations, live entitlement management).

Anti-triggers

Do not use this CLI for:

• Do not use this CLI for Azure resource management (VMs, storage, AKS) — use the az CLI instead.
• Do not use this CLI for GitHub repositories — use the gh CLI.
• Do not use this CLI for reading raw file content from Azure Blob Storage.
• Do not use this CLI for Azure Boards queries that require real-time board state not yet synced.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• standup — See your PRs awaiting review, in-progress work items, and newly failed builds in one command — ready before the standup meeting.

  Use this when an agent needs a quick briefing on a developer's current work state before creating tasks or PRs on their behalf.

  azure-devops-pp-cli standup --agent
  

• velocity — See sprint-over-sprint velocity with trend line for the current team — points completed vs committed, across the last N sprints.

  Use this when an agent needs to assess team capacity or forecast delivery dates based on historical throughput.

  azure-devops-pp-cli velocity --sprints 6 --agent
  

• work sprint-creep — See which work items were added to the current sprint after it started, with total story points of scope added mid-sprint.

  Use this when an agent needs to identify whether a sprint is at risk due to scope expansion after commit.

  azure-devops-pp-cli work sprint-creep --team ENG --json
  

• work rollover — Find work items that have been moved to a new sprint more than once — the chronic blockers that keep slipping through sprint planning.

  Use this when an agent needs to identify persistent delivery risks before sprint planning.

  azure-devops-pp-cli work rollover --min-rollovers 2 --agent
  

• pipeline flaky — Identify build stages with the highest intermittent failure rate over the last N runs — the stages that fail and then pass without code changes.

  Use this when an agent needs to identify which pipeline stages are unreliable test signals before acting on build failures.

  azure-devops-pp-cli pipeline flaky --definition-id 42 --last 30 --agent
  

• wit cycle-time — Measure average time from Active to Done per work item type over a date range — the team's true delivery throughput.

  Use this when an agent needs to estimate realistic delivery timelines based on historical cycle time.

  azure-devops-pp-cli wit cycle-time --type Bug --weeks 12 --agent
  

• git branch-health — See a health dashboard for every repo in the project: default branch build status, last commit age, and open PR count — in one table.

  Use this when an agent needs to assess overall code health across a multi-repo project before planning changes.

  azure-devops-pp-cli git branch-health --agent --select repo,buildStatus,lastCommitDays,openPRs
  

• work area-load — See open work item counts and total story points grouped by area path — to spot overloaded teams or abandoned backlogs.

  Use this when an agent needs to identify which teams have the most outstanding work before assigning new items.

  azure-devops-pp-cli work area-load --state Active --agent
  

• pr aging — Find pull requests with no reviewer activity for N or more days, grouped by author — to surface forgotten PRs before they go stale.

  Use this when an agent needs to identify PRs that are at risk of losing context due to review delays.

  azure-devops-pp-cli pr aging --days 3 --agent
  

• branches stale — List branches that are safe to delete: already merged into default, no open PRs, and no commits in the last N days.

  Use this when an agent is helping clean up a repository's branch proliferation.

  azure-devops-pp-cli branches stale --repo myapp --days 30 --agent
  

• builds cost — See agent minutes consumed per pipeline per week over the last N weeks — to find pipelines that are growing in CI cost.

  Use this when an agent needs to identify which pipelines are contributing to growing CI/CD costs.

  azure-devops-pp-cli builds cost --weeks 8 --agent
  

Agent-native plumbing

• pr review-queue — See only the PRs where you are a required reviewer, the build is passing, and no other required reviewer has voted yet — ordered by readiness.

  Use this when an agent needs to identify which PRs a developer should review first to unblock teammates.

  azure-devops-pp-cli pr review-queue --agent --select title,buildStatus,waitingReviewers
  

• release gate-queue — See all release gates and YAML pipeline stages currently waiting for your approval across every pipeline, with how long each has been waiting.

  Use this when an agent needs to identify which deployments are blocked on human approval and how urgent each is.

  azure-devops-pp-cli release gate-queue --agent --select pipelineName,stageName,waitMinutes
  

• work diff — Show exactly which fields changed between two revisions of a work item — a git-style diff for specification and acceptance criteria.

  Use this when an agent needs to understand what changed in a work item's requirements between two points in time.

  azure-devops-pp-cli work diff --id 4812 --from 3 --to 7 --agent
  

• git commit-builds — Given a commit SHA, see every build and pipeline run that included that commit and whether it passed or failed.

  Use this when an agent needs to determine whether a specific code change has been validated by CI.

  azure-devops-pp-cli git commit-builds --sha a1b2c3d4 --repo myapp --agent
  

Command Reference

apis — Manage apis

• azure-devops-pp-cli apis avatar-remove-project-avatar — Removes the avatar for the project.
• azure-devops-pp-cli apis avatar-set-project-avatar — Sets the avatar for the project.
• azure-devops-pp-cli apis categorized-teams-get — Gets list of user readable teams in a project and teams user is member of (excluded from readable list).
• azure-devops-pp-cli apis processes-get — Get a process by ID.
• azure-devops-pp-cli apis processes-list — Get a list of processes.
• azure-devops-pp-cli apis projects-create — Queues a project to be created. Use the [GetOperation](../..
• azure-devops-pp-cli apis projects-delete — Queues a project to be deleted. Use the [GetOperation](../..
• azure-devops-pp-cli apis projects-get — Get project with the specified id or name, optionally including capabilities.
• azure-devops-pp-cli apis projects-get-project-properties — Get a collection of team project properties.
• azure-devops-pp-cli apis projects-list — Get all projects in the organization that the authenticated user has access to.
• azure-devops-pp-cli apis projects-set-project-properties — Create, update, and delete team project properties.
• azure-devops-pp-cli apis projects-update — Update an existing project's name, abbreviation, description, or restore a project.
• azure-devops-pp-cli apis teams-create — Create a team in a team project.
• azure-devops-pp-cli apis teams-delete — Delete a team.
• azure-devops-pp-cli apis teams-get — Get a specific team.
• azure-devops-pp-cli apis teams-get-all-teams — Get a list of all teams.
• azure-devops-pp-cli apis teams-get-team-members-with-extended-properties — Get a list of members for a specific team.
• azure-devops-pp-cli apis teams-get-teams — Get a list of teams.
• azure-devops-pp-cli apis teams-update — Update a team's name and/or description.

build-apis — Manage build apis

• azure-devops-pp-cli build-apis artifacts-create — Associates an artifact with a build.
• azure-devops-pp-cli build-apis artifacts-list — Gets all artifacts for a build.
• azure-devops-pp-cli build-apis attachments-get — Gets a specific attachment.
• azure-devops-pp-cli build-apis attachments-list — Gets the list of attachments of a specific type that are associated with a build.
• azure-devops-pp-cli build-apis authorizedresources-authorize-project-resources — Authorizedresources authorize project resources
• azure-devops-pp-cli build-apis authorizedresources-list — Authorizedresources list
• azure-devops-pp-cli build-apis badge-get-build-badge-data — Gets a badge that indicates the status of the most recent build for the specified branch.
• azure-devops-pp-cli build-apis builds-delete — Deletes a build.
• azure-devops-pp-cli build-apis builds-get — Gets a build
• azure-devops-pp-cli build-apis builds-get-build-changes — Gets the changes associated with a build
• azure-devops-pp-cli build-apis builds-get-build-log — Gets an individual log file for a build.
• azure-devops-pp-cli build-apis builds-get-build-logs — Gets the logs for a build.
• azure-devops-pp-cli build-apis builds-get-build-work-items-refs — Gets the work items associated with a build. Only work items in the same project are returned.
• azure-devops-pp-cli build-apis builds-get-build-work-items-refs-from-commits — Gets the work items associated with a build, filtered to specific commits.
• azure-devops-pp-cli build-apis builds-get-changes-between-builds — Gets the changes made to the repository between two given builds.
• azure-devops-pp-cli build-apis builds-get-retention-leases-for-build — Gets all retention leases that apply to a specific build.
• azure-devops-pp-cli build-apis builds-get-work-items-between-builds — Gets all the work items between two builds.
• azure-devops-pp-cli build-apis builds-list — Gets a list of builds.
• azure-devops-pp-cli build-apis builds-queue — Queues a build
• azure-devops-pp-cli build-apis builds-update-build — Updates a build.
• azure-devops-pp-cli build-apis builds-update-builds — Updates multiple builds.
• azure-devops-pp-cli build-apis definitions-create — Creates a new definition.
• azure-devops-pp-cli build-apis definitions-delete — Deletes a definition and all associated builds.
• azure-devops-pp-cli build-apis definitions-get — Gets a definition, optionally at a specific revision.
• azure-devops-pp-cli build-apis definitions-get-definition-revisions — Gets all revisions of a definition.
• azure-devops-pp-cli build-apis definitions-list — Gets a list of definitions.
• azure-devops-pp-cli build-apis definitions-restore-definition — Restores a deleted definition
• azure-devops-pp-cli build-apis definitions-update — Updates an existing build definition.
• azure-devops-pp-cli build-apis folders-create — Creates a new folder.
• azure-devops-pp-cli build-apis folders-delete — Deletes a definition folder. Definitions and their corresponding builds will also be deleted.
• azure-devops-pp-cli build-apis folders-list — Gets a list of build definition folders.
• azure-devops-pp-cli build-apis folders-update — Updates an existing folder at given existing path
• azure-devops-pp-cli build-apis general-settings-get — Gets pipeline general settings.
• azure-devops-pp-cli build-apis general-settings-update — Updates pipeline general settings.
• azure-devops-pp-cli build-apis latest-get — Gets the latest build for a definition, optionally scoped to a specific branch.
• azure-devops-pp-cli build-apis leases-add — Adds new leases for pipeline runs.
• azure-devops-pp-cli build-apis leases-delete — Removes specific retention leases.
• azure-devops-pp-cli build-apis leases-get — Returns the details of the retention lease given a lease id.
• azure-devops-pp-cli build-apis leases-get-retention-leases-by-minimal-retention-leases — Returns any leases matching the specified MinimalRetentionLeases
• azure-devops-pp-cli build-apis leases-update — Updates the duration or pipeline protection status of a retention lease.
• azure-devops-pp-cli build-apis metrics-get-definition-metrics — Gets build metrics for a definition.
• azure-devops-pp-cli build-apis metrics-get-project-metrics — Gets build metrics for a project.
• azure-devops-pp-cli build-apis options-list — Gets all build definition options supported by the system.
• azure-devops-pp-cli build-apis properties-get-build-properties — Gets properties for a build.
• azure-devops-pp-cli build-apis properties-get-definition-properties — Gets properties for a definition.
• azure-devops-pp-cli build-apis properties-update-build-properties — Updates properties for a build.
• azure-devops-pp-cli build-apis properties-update-definition-properties — Updates properties for a definition.
• azure-devops-pp-cli build-apis report-get — Gets a build report.
• azure-devops-pp-cli build-apis resources-authorize-definition-resources — Resources authorize definition resources
• azure-devops-pp-cli build-apis resources-list — Resources list
• azure-devops-pp-cli build-apis retention-get — Gets the project's retention settings.
• azure-devops-pp-cli build-apis retention-update — Updates the project's retention settings.
• azure-devops-pp-cli build-apis settings-get — Gets the build settings.
• azure-devops-pp-cli build-apis settings-update — Updates the build settings.
• azure-devops-pp-cli build-apis source-providers-get-file-contents — Gets the contents of a file in the given source code repository.
• azure-devops-pp-cli build-apis source-providers-get-path-contents — Gets the contents of a directory in the given source code repository.
• azure-devops-pp-cli build-apis source-providers-get-pull-request — Gets a pull request object from source provider.
• azure-devops-pp-cli build-apis source-providers-list — Get a list of source providers and their capabilities.
• azure-devops-pp-cli build-apis source-providers-list-branches — Gets a list of branches for the given source code repository.
• azure-devops-pp-cli build-apis source-providers-list-repositories — Gets a list of source code repositories.
• azure-devops-pp-cli build-apis source-providers-list-webhooks — Gets a list of webhooks installed in the given source code repository.
• azure-devops-pp-cli build-apis source-providers-restore-webhooks — Recreates the webhooks for the specified triggers in the given source code repository.
• azure-devops-pp-cli build-apis stages-update — Update a build stage
• azure-devops-pp-cli build-apis status-get — Gets the build status for a definition, optionally scoped to a specific branch, stage, job, and configuration.
• azure-devops-pp-cli build-apis tags-add-build-tag — Adds a tag to a build.
• azure-devops-pp-cli build-apis tags-add-build-tags — Adds tags to a build.
• azure-devops-pp-cli build-apis tags-add-definition-tag — Adds a tag to a definition
• azure-devops-pp-cli build-apis tags-add-definition-tags — Adds multiple tags to a definition.
• azure-devops-pp-cli build-apis tags-delete-build-tag — Removes a tag from a build. NOTE: This API will not work for tags with special characters.
• azure-devops-pp-cli build-apis tags-delete-definition-tag — Removes a tag from a definition. NOTE: This API will not work for tags with special characters.
• azure-devops-pp-cli build-apis tags-delete-tag — Removes a tag from builds, definitions, and from the tag store
• azure-devops-pp-cli build-apis tags-get-build-tags — Gets the tags for a build.
• azure-devops-pp-cli build-apis tags-get-definition-tags — Gets the tags for a definition.
• azure-devops-pp-cli build-apis tags-get-tags — Gets a list of all build tags in the project.
• azure-devops-pp-cli build-apis tags-update-build-tags — Adds/Removes tags from a build.
• azure-devops-pp-cli build-apis tags-update-definition-tags — Adds/Removes tags from a definition.
• azure-devops-pp-cli build-apis templates-delete — Deletes a build definition template.
• azure-devops-pp-cli build-apis templates-get — Gets a specific build definition template.
• azure-devops-pp-cli build-apis templates-list — Gets all definition templates.
• azure-devops-pp-cli build-apis templates-save-template — Updates an existing build definition template.
• azure-devops-pp-cli build-apis timeline-get — Gets details for a build
• azure-devops-pp-cli build-apis yaml-get — Converts a definition to YAML, optionally at a specific revision.

git-apis — Manage git apis

• azure-devops-pp-cli git-apis annotated-tags-create — Create an annotated tag. Repositories have both a name and an identifier.
• azure-devops-pp-cli git-apis annotated-tags-get — Get an annotated tag. Repositories have both a name and an identifier.
• azure-devops-pp-cli git-apis blobs-get-blob — Get a single blob. Repositories have both a name and an identifier.
• azure-devops-pp-cli git-apis blobs-get-blobs-zip — Gets one or more blobs in a zip file download.
• azure-devops-pp-cli git-apis cherry-picks-create — Cherry pick a specific commit or commits that are associated to a pull request into a new branch.
• azure-devops-pp-cli git-apis cherry-picks-get-cherry-pick — Retrieve information about a cherry pick operation by cherry pick Id.
• azure-devops-pp-cli git-apis cherry-picks-get-cherry-pick-for-ref-name — Retrieve information about a cherry pick operation for a specific branch.
• azure-devops-pp-cli git-apis commits-get — Retrieve a particular commit.
• azure-devops-pp-cli git-apis commits-get-changes — Retrieve changes for a particular commit.
• azure-devops-pp-cli git-apis commits-get-commits-batch — Retrieve git commits for a project matching the search criteria
• azure-devops-pp-cli git-apis commits-get-push-commits — Retrieve a list of commits associated with a particular push.
• azure-devops-pp-cli git-apis diffs-get — Find the closest common commit (the merge base) between base and target commits
• azure-devops-pp-cli git-apis forks-create-fork-sync-request — Request that another repository's refs be fetched into this one. It syncs two existing forks.
• azure-devops-pp-cli git-apis forks-get-fork-sync-request — Get a specific fork sync operation's details.
• azure-devops-pp-cli git-apis forks-get-fork-sync-requests — Retrieve all requested fork sync operations on this repository.
• azure-devops-pp-cli git-apis forks-list — Retrieve all forks of a repository in the collection.
• azure-devops-pp-cli git-apis import-requests-create — Create an import request.
• azure-devops-pp-cli git-apis import-requests-get — Retrieve a particular import request.
• azure-devops-pp-cli git-apis import-requests-query — Retrieve import requests for a repository.
• azure-devops-pp-cli git-apis import-requests-update — Retry or abandon a failed import request. There can only be one active import request associated with a repository.
• azure-devops-pp-cli git-apis items-get-items-batch — Retrieves a batch of items in a repo / project for a given list of paths or a long path
• azure-devops-pp-cli git-apis items-list — Get Item Metadata and/or Content for a collection of items.
• azure-devops-pp-cli git-apis merge-bases-list — Find the merge bases of two commits, optionally across forks.
• azure-devops-pp-cli git-apis merges-create — Request a git merge operation. Currently we support merging only 2 commits.
• azure-devops-pp-cli git-apis merges-get — Get a specific merge operation's details.
• azure-devops-pp-cli git-apis policy-configurations-get — Retrieve a list of policy configurations by a given set of scope/filtering criteria.
• azure-devops-pp-cli git-apis pull-request-attachments-create — Attach a new file to a pull request.
• azure-devops-pp-cli git-apis pull-request-attachments-delete — Delete a pull request attachment.
• azure-devops-pp-cli git-apis pull-request-attachments-get — Get the file content of a pull request attachment.
• azure-devops-pp-cli git-apis pull-request-attachments-list — Get a list of files attached to a given pull request.
• azure-devops-pp-cli git-apis pull-request-comment-likes-create — Add a like on a comment.
• azure-devops-pp-cli git-apis pull-request-comment-likes-delete — Delete a like on a comment.
• azure-devops-pp-cli git-apis pull-request-comment-likes-list — Get likes for a comment.
• azure-devops-pp-cli git-apis pull-request-commits-get-pull-request-commits — Get the commits for the specified pull request.
• azure-devops-pp-cli git-apis pull-request-commits-get-pull-request-iteration-commits — Get the commits for the specified iteration of a pull request.
• azure-devops-pp-cli git-apis pull-request-iteration-changes-get — Retrieve the changes made in a pull request between two iterations.
• azure-devops-pp-cli git-apis pull-request-iteration-statuses-create — Create a pull request status on the iteration.
• azure-devops-pp-cli git-apis pull-request-iteration-statuses-delete — Delete pull request iteration status. You can remove multiple statuses in one call by using Update operation.
• azure-devops-pp-cli git-apis pull-request-iteration-statuses-get — Get the specific pull request iteration status by ID.
• azure-devops-pp-cli git-apis pull-request-iteration-statuses-list — Get all the statuses associated with a pull request iteration.
• azure-devops-pp-cli git-apis pull-request-iteration-statuses-update — Update pull request iteration statuses collection. The only supported operation type is remove.
• azure-devops-pp-cli git-apis pull-request-iterations-get — Get the specified iteration for a pull request.
• azure-devops-pp-cli git-apis pull-request-iterations-list — Get the list of iterations for the specified pull request.
• azure-devops-pp-cli git-apis pull-request-labels-create — Create a tag (if that does not exists yet) and add that as a label (tag) for a specified pull request.
• azure-devops-pp-cli git-apis pull-request-labels-delete — Removes a label (tag) from the set of those assigned to the pull request. The tag itself will not be deleted.
• azure-devops-pp-cli git-apis pull-request-labels-get — Retrieves a single label (tag) that has been assigned to a pull request.
• azure-devops-pp-cli git-apis pull-request-labels-list — Get all the labels (tags) assigned to a pull request.
• azure-devops-pp-cli git-apis pull-request-properties-list — Get external properties of the pull request.
• azure-devops-pp-cli git-apis pull-request-properties-update — Create or update pull request external properties. The patch operation can be add, replace or remove.
• azure-devops-pp-cli git-apis pull-request-query-get — This API is used to find what pull requests are related to a given commit.
• azure-devops-pp-cli git-apis pull-request-reviewers-create-pull-request-reviewer — Add a reviewer to a pull request or cast a vote.
• azure-devops-pp-cli git-apis pull-request-reviewers-create-pull-request-reviewers — Add reviewers to a pull request.
• azure-devops-pp-cli git-apis pull-request-reviewers-create-unmaterialized-pull-request-reviewer — Add an unmaterialized identity to the reviewers of a pull request.
• azure-devops-pp-cli git-apis pull-request-reviewers-delete — Remove a reviewer from a pull request.
• azure-devops-pp-cli git-apis pull-request-reviewers-get — Retrieve information about a particular reviewer on a pull request
• azure-devops-pp-cli git-apis pull-request-reviewers-list — Retrieve the reviewers for a pull request
• azure-devops-pp-cli git-apis pull-request-reviewers-update-pull-request-reviewer — Edit a reviewer entry. These fields are patchable: isFlagged, hasDeclined
• azure-devops-pp-cli git-apis pull-request-reviewers-update-pull-request-reviewers — Reset the votes of multiple reviewers on a pull request.
• azure-devops-pp-cli git-apis pull-request-share-share-pull-request — Sends an e-mail notification about a specific pull request to a set of recipients
• azure-devops-pp-cli git-apis pull-request-statuses-create — Create a pull request status. The only required field for the status is `Context.
• azure-devops-pp-cli git-apis pull-request-statuses-delete — Delete pull request status. You can remove multiple statuses in one call by using Update operation.
• azure-devops-pp-cli git-apis pull-request-statuses-get — Get the specific pull request status by ID. The status ID is unique within the pull request across all iterations.
• azure-devops-pp-cli git-apis pull-request-statuses-list — Get all the statuses associated with a pull request.
• azure-devops-pp-cli git-apis pull-request-statuses-update — Update pull request statuses collection. The only supported operation type is remove.
• azure-devops-pp-cli git-apis pull-request-thread-comments-create — Create a comment on a specific thread in a pull request (up to 500 comments can be created per thread).
• azure-devops-pp-cli git-apis pull-request-thread-comments-delete — Delete a comment associated with a specific thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-thread-comments-get — Retrieve a comment associated with a specific thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-thread-comments-list — Retrieve all comments associated with a specific thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-thread-comments-update — Update a comment associated with a specific thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-threads-create — Create a thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-threads-get — Retrieve a thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-threads-list — Retrieve all threads in a pull request.
• azure-devops-pp-cli git-apis pull-request-threads-update — Update a thread in a pull request.
• azure-devops-pp-cli git-apis pull-request-work-items-list — Retrieve a list of work items associated with a pull request.
• azure-devops-pp-cli git-apis pull-requests-create — Create a pull request.
• azure-devops-pp-cli git-apis pull-requests-get-pull-request — Retrieve a pull request.
• azure-devops-pp-cli git-apis pull-requests-get-pull-request-by-id — Retrieve a pull request.
• azure-devops-pp-cli git-apis pull-requests-get-pull-requests — Retrieve all pull requests matching a specified criteria.
• azure-devops-pp-cli git-apis pull-requests-get-pull-requests-by-project — Retrieve all pull requests matching a specified criteria.
• azure-devops-pp-cli git-apis pull-requests-update — Update a pull request These are the properties that can be updated with the API
• azure-devops-pp-cli git-apis pushes-create — Push changes to the repository.
• azure-devops-pp-cli git-apis pushes-get — Retrieves a particular push.
• azure-devops-pp-cli git-apis pushes-list — Retrieves pushes associated with the specified repository.
• azure-devops-pp-cli git-apis refs-favorites-create — Creates a ref favorite
• azure-devops-pp-cli git-apis refs-favorites-delete — Deletes the refs favorite specified
• azure-devops-pp-cli git-apis refs-favorites-get — Gets the refs favorite for a favorite Id.
• azure-devops-pp-cli git-apis refs-favorites-list — Gets the refs favorites for a repo and an identity.
• azure-devops-pp-cli git-apis refs-list — Queries the provided repository for its refs and returns them.
• azure-devops-pp-cli git-apis refs-update-ref — Lock or Unlock a branch.
• azure-devops-pp-cli git-apis refs-update-refs — Creating, updating, or deleting refs(branches).
• azure-devops-pp-cli git-apis repositories-create — Create a git repository in a team project.
• azure-devops-pp-cli git-apis repositories-delete — Delete a git repository
• azure-devops-pp-cli git-apis repositories-delete-repository-from-recycle-bin — Destroy (hard delete) a soft-deleted Git repository.
• azure-devops-pp-cli git-apis repositories-get-deleted-repositories — Retrieve deleted git repositories.
• azure-devops-pp-cli git-apis repositories-get-recycle-bin-repositories — Retrieve soft-deleted git repositories from the recycle bin.
• azure-devops-pp-cli git-apis repositories-get-repository — Retrieve a git repository.
• azure-devops-pp-cli git-apis repositories-list — Retrieve git repositories.
• azure-devops-pp-cli git-apis repositories-restore-repository-from-recycle-bin — Recover a soft-deleted Git repository.
• azure-devops-pp-cli git-apis repositories-update — Updates the Git repository with either a new repo name or a new default branch.
• azure-devops-pp-cli git-apis reverts-create — Starts the operation to create a new branch which reverts changes introduced by either a specific commit or commits
• azure-devops-pp-cli git-apis reverts-get-revert — Retrieve information about a revert operation by revert Id.
• azure-devops-pp-cli git-apis reverts-get-revert-for-ref-name — Retrieve information about a revert operation for a specific branch.
• azure-devops-pp-cli git-apis stats-list — Retrieve statistics about all branches within a repository.
• azure-devops-pp-cli git-apis statuses-create — Create Git commit status.
• azure-devops-pp-cli git-apis statuses-list — Get statuses associated with the Git commit.
• azure-devops-pp-cli git-apis suggestions-list — Retrieve a pull request suggestion for a particular repository or team project.
• azure-devops-pp-cli git-apis trees-get — The Tree endpoint returns the collection of objects underneath the specified tree.

pipelines-apis — Manage pipelines apis

• azure-devops-pp-cli pipelines-apis artifacts-get — Get a specific artifact from a pipeline run
• azure-devops-pp-cli pipelines-apis logs-get — Get a specific log from a pipeline run
• azure-devops-pp-cli pipelines-apis logs-list — Get a list of logs from a pipeline run.
• azure-devops-pp-cli pipelines-apis pipelines-create — Create a pipeline.
• azure-devops-pp-cli pipelines-apis pipelines-get — Gets a pipeline, optionally at the specified version
• azure-devops-pp-cli pipelines-apis pipelines-list — Get a list of pipelines.
• azure-devops-pp-cli pipelines-apis preview-preview — Queues a dry run of the pipeline and returns an object containing the final yaml.
• azure-devops-pp-cli pipelines-apis runs-get — Gets a run for a particular pipeline.
• azure-devops-pp-cli pipelines-apis runs-list — Gets top 10000 runs for a particular pipeline.
• azure-devops-pp-cli pipelines-apis runs-run-pipeline — Runs a pipeline.

release-apis — Manage release apis

• azure-devops-pp-cli release-apis approvals-list — Get a list of approvals
• azure-devops-pp-cli release-apis approvals-update — Update status of an approval
• azure-devops-pp-cli release-apis attachments-get-release-task-attachment-content — Get a release task attachment.
• azure-devops-pp-cli release-apis attachments-get-release-task-attachments — Get the release task attachments.
• azure-devops-pp-cli release-apis attachments-get-task-attachment-content — GetTaskAttachmentContent API is deprecated. Use GetReleaseTaskAttachmentContent API instead.
• azure-devops-pp-cli release-apis attachments-get-task-attachments — GetTaskAttachments API is deprecated. Use GetReleaseTaskAttachments API instead.
• azure-devops-pp-cli release-apis definitions-create — Create a release definition
• azure-devops-pp-cli release-apis definitions-delete — Delete a release definition.
• azure-devops-pp-cli release-apis definitions-get — Get a release definition.
• azure-devops-pp-cli release-apis definitions-get-definition-revision — Get release definition for a given definitionId and revision
• azure-devops-pp-cli release-apis definitions-get-release-definition-history — Get revision history for a release definition
• azure-devops-pp-cli release-apis definitions-list — Get a list of release definitions.
• azure-devops-pp-cli release-apis definitions-update — Update a release definition.
• azure-devops-pp-cli release-apis deployments-list — Deployments list
• azure-devops-pp-cli release-apis folders-create — This method is no longer supported. Use CreateFolder with folder parameter API.
• azure-devops-pp-cli release-apis folders-delete — Deletes a definition folder for given folder name and path and all it's existing definitions.
• azure-devops-pp-cli release-apis folders-list — Gets folders.
• azure-devops-pp-cli release-apis folders-update — Updates an existing folder at given existing path.
• azure-devops-pp-cli release-apis gates-update — Updates the gate for a deployment.
• azure-devops-pp-cli release-apis manual-interventions-get — Get manual intervention for a given release and manual intervention id.
• azure-devops-pp-cli release-apis manual-interventions-list — List all manual interventions for a given release.
• azure-devops-pp-cli release-apis manual-interventions-update — Update manual intervention.
• azure-devops-pp-cli release-apis releases-create — Create a release.
• azure-devops-pp-cli release-apis releases-get-logs — Get logs for a release Id.
• azure-devops-pp-cli release-apis releases-get-release-environment — Get a release environment.
• azure-devops-pp-cli release-apis releases-get-release-revision — Get release for a given revision number.
• azure-devops-pp-cli release-apis releases-get-task-log — Gets the task log of a release as a plain text file.
• azure-devops-pp-cli release-apis releases-list — Get a list of releases
• azure-devops-pp-cli release-apis releases-update-release — Update a complete release object.
• azure-devops-pp-cli release-apis releases-update-release-environment — Update the status of a release environment
• azure-devops-pp-cli release-apis releases-update-release-resource — Update few properties of a release.

search-apis — Manage search apis

• azure-devops-pp-cli search-apis <organization> — Provides a set of results for the search text.

wiki-apis — Manage wiki apis

• azure-devops-pp-cli wiki-apis attachments-create — Creates an attachment in the wiki.
• azure-devops-pp-cli wiki-apis page-moves-create — Creates a page move operation that updates the path and order of the page as provided in the parameters.
• azure-devops-pp-cli wiki-apis page-stats-get — Returns page detail corresponding to Page ID.
• azure-devops-pp-cli wiki-apis pages-batch-get — Returns pageable list of Wiki Pages
• azure-devops-pp-cli wiki-apis pages-create-or-update — Creates or edits a wiki page.
• azure-devops-pp-cli wiki-apis pages-delete-page — Deletes a wiki page.
• azure-devops-pp-cli wiki-apis pages-delete-page-by-id — Deletes a wiki page.
• azure-devops-pp-cli wiki-apis pages-get-page — Gets metadata or content of the wiki page for the provided path.
• azure-devops-pp-cli wiki-apis pages-get-page-by-id — Gets metadata or content of the wiki page for the provided page id.
• azure-devops-pp-cli wiki-apis pages-update — Edits a wiki page.
• azure-devops-pp-cli wiki-apis wikis-create — Creates the wiki resource.
• azure-devops-pp-cli wiki-apis wikis-delete — Deletes the wiki corresponding to the wiki ID or wiki name provided.
• azure-devops-pp-cli wiki-apis wikis-get — Gets the wiki corresponding to the wiki ID or wiki name provided.
• azure-devops-pp-cli wiki-apis wikis-list — Gets all wikis in a project or collection.
• azure-devops-pp-cli wiki-apis wikis-update — Updates the wiki corresponding to the wiki ID or wiki name provided using the update parameters.

work-apis — Manage work apis

• azure-devops-pp-cli work-apis boardcolumns-list — Get available board columns in a project
• azure-devops-pp-cli work-apis boardrows-list — Get available board rows in a project
• azure-devops-pp-cli work-apis deliverytimeline-get — Get Delivery View Data
• azure-devops-pp-cli work-apis iterationcapacities-get — Get an iteration's capacity for all teams in iteration
• azure-devops-pp-cli work-apis plans-create — Add a new plan for the team
• azure-devops-pp-cli work-apis plans-delete — Delete the specified plan
• azure-devops-pp-cli work-apis plans-get — Get the information for the specified plan
• azure-devops-pp-cli work-apis plans-list — Get the information for all the plans configured for the given team
• azure-devops-pp-cli work-apis plans-update — Update the information for the specified plan
• azure-devops-pp-cli work-apis processconfiguration-get — Get process configuration

workitemtracking-apis — Manage workitemtracking apis

• azure-devops-pp-cli workitemtracking-apis account-my-work-recent-activity-list — Gets recent work item activities
• azure-devops-pp-cli workitemtracking-apis artifact-link-types-list — Get the list of work item tracking outbound artifact link types.
• azure-devops-pp-cli workitemtracking-apis work-item-icons-get — Get a work item icon given the friendly name and icon color.
• azure-devops-pp-cli workitemtracking-apis work-item-icons-list — Get a list of all work item icons.
• azure-devops-pp-cli workitemtracking-apis work-item-relation-types-get — Gets the work item relation type definition.
• azure-devops-pp-cli workitemtracking-apis work-item-relation-types-list — Gets the work item relation types.
• azure-devops-pp-cli workitemtracking-apis work-item-transitions-list — Returns the next state on the given work item IDs.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

azure-devops-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2

…(truncated)