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:
- 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
- Verify:
azure-devops-pp-cli --version
- 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)
1---
2name: pp-azure-devops
3description: "The fastest Azure DevOps CLI — offline-first, agent-native Trigger phrases: `show my Azure DevOps work items`, `check my ADO pull requests`, `what's the sprint velocity`, `which PRs need my review`, `check Azure DevOps pipeline status`, `use azure-devops`, `run azure-devops`."
4author: "davbebawwy"
5license: "Apache-2.0"
6argument-hint: "<command> [args] | install cli|mcp"
7allowed-tools: "Read Bash"
8metadata:
9 source: https://skillmd.com/skills/mvanhorn-printing-press-libra/pp-azure-devops
10 openclaw:
11 requires:
12 bins:
13 - azure-devops-pp-cli
14 install:
15 - kind: go
16 bins: [azure-devops-pp-cli]
17 module: github.com/mvanhorn/printing-press-library/library/developer-tools/azure-devops/cmd/azure-devops-pp-cli
18---
19<!-- GENERATED FILE — DO NOT EDIT.
20 This file is a verbatim mirror of library/developer-tools/azure-devops/SKILL.md,
21 regenerated post-merge by tools/generate-skills/. Hand-edits here are
22 silently overwritten on the next regen. Edit the library/ source instead.
23 See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->
24
25# Azure DevOps — Printing Press CLI
26
27## Prerequisites: Install the CLI
28
29This 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:
30
311. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
32 ```bash
33 npx -y @mvanhorn/printing-press-library install azure-devops --cli-only
34 ```
352. Verify: `azure-devops-pp-cli --version`
363. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.
37
38If 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:
39
40```bash
41go install github.com/mvanhorn/printing-press-library/library/developer-tools/azure-devops/cmd/azure-devops-pp-cli@latest
42```
43
44If `--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.
45
46azure-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.
47
48## When to Use This CLI
49
50Use 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).
51
52## Anti-triggers
53
54Do not use this CLI for:
55- Do not use this CLI for Azure resource management (VMs, storage, AKS) — use the `az` CLI instead.
56- Do not use this CLI for GitHub repositories — use the `gh` CLI.
57- Do not use this CLI for reading raw file content from Azure Blob Storage.
58- Do not use this CLI for Azure Boards queries that require real-time board state not yet synced.
59
60## Unique Capabilities
61
62These capabilities aren't available in any other tool for this API.
63
64### Local state that compounds
65- **`standup`** — See your PRs awaiting review, in-progress work items, and newly failed builds in one command — ready before the standup meeting.
66
67 _Use this when an agent needs a quick briefing on a developer's current work state before creating tasks or PRs on their behalf._
68
69 ```bash
70 azure-devops-pp-cli standup --agent
71 ```
72- **`velocity`** — See sprint-over-sprint velocity with trend line for the current team — points completed vs committed, across the last N sprints.
73
74 _Use this when an agent needs to assess team capacity or forecast delivery dates based on historical throughput._
75
76 ```bash
77 azure-devops-pp-cli velocity --sprints 6 --agent
78 ```
79- **`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.
80
81 _Use this when an agent needs to identify whether a sprint is at risk due to scope expansion after commit._
82
83 ```bash
84 azure-devops-pp-cli work sprint-creep --team ENG --json
85 ```
86- **`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.
87
88 _Use this when an agent needs to identify persistent delivery risks before sprint planning._
89
90 ```bash
91 azure-devops-pp-cli work rollover --min-rollovers 2 --agent
92 ```
93- **`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.
94
95 _Use this when an agent needs to identify which pipeline stages are unreliable test signals before acting on build failures._
96
97 ```bash
98 azure-devops-pp-cli pipeline flaky --definition-id 42 --last 30 --agent
99 ```
100- **`wit cycle-time`** — Measure average time from Active to Done per work item type over a date range — the team's true delivery throughput.
101
102 _Use this when an agent needs to estimate realistic delivery timelines based on historical cycle time._
103
104 ```bash
105 azure-devops-pp-cli wit cycle-time --type Bug --weeks 12 --agent
106 ```
107- **`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.
108
109 _Use this when an agent needs to assess overall code health across a multi-repo project before planning changes._
110
111 ```bash
112 azure-devops-pp-cli git branch-health --agent --select repo,buildStatus,lastCommitDays,openPRs
113 ```
114- **`work area-load`** — See open work item counts and total story points grouped by area path — to spot overloaded teams or abandoned backlogs.
115
116 _Use this when an agent needs to identify which teams have the most outstanding work before assigning new items._
117
118 ```bash
119 azure-devops-pp-cli work area-load --state Active --agent
120 ```
121- **`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.
122
123 _Use this when an agent needs to identify PRs that are at risk of losing context due to review delays._
124
125 ```bash
126 azure-devops-pp-cli pr aging --days 3 --agent
127 ```
128- **`branches stale`** — List branches that are safe to delete: already merged into default, no open PRs, and no commits in the last N days.
129
130 _Use this when an agent is helping clean up a repository's branch proliferation._
131
132 ```bash
133 azure-devops-pp-cli branches stale --repo myapp --days 30 --agent
134 ```
135- **`builds cost`** — See agent minutes consumed per pipeline per week over the last N weeks — to find pipelines that are growing in CI cost.
136
137 _Use this when an agent needs to identify which pipelines are contributing to growing CI/CD costs._
138
139 ```bash
140 azure-devops-pp-cli builds cost --weeks 8 --agent
141 ```
142
143### Agent-native plumbing
144- **`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.
145
146 _Use this when an agent needs to identify which PRs a developer should review first to unblock teammates._
147
148 ```bash
149 azure-devops-pp-cli pr review-queue --agent --select title,buildStatus,waitingReviewers
150 ```
151- **`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.
152
153 _Use this when an agent needs to identify which deployments are blocked on human approval and how urgent each is._
154
155 ```bash
156 azure-devops-pp-cli release gate-queue --agent --select pipelineName,stageName,waitMinutes
157 ```
158- **`work diff`** — Show exactly which fields changed between two revisions of a work item — a git-style diff for specification and acceptance criteria.
159
160 _Use this when an agent needs to understand what changed in a work item's requirements between two points in time._
161
162 ```bash
163 azure-devops-pp-cli work diff --id 4812 --from 3 --to 7 --agent
164 ```
165- **`git commit-builds`** — Given a commit SHA, see every build and pipeline run that included that commit and whether it passed or failed.
166
167 _Use this when an agent needs to determine whether a specific code change has been validated by CI._
168
169 ```bash
170 azure-devops-pp-cli git commit-builds --sha a1b2c3d4 --repo myapp --agent
171 ```
172
173## Command Reference
174
175**apis** — Manage apis
176
177- `azure-devops-pp-cli apis avatar-remove-project-avatar` — Removes the avatar for the project.
178- `azure-devops-pp-cli apis avatar-set-project-avatar` — Sets the avatar for the project.
179- `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).
180- `azure-devops-pp-cli apis processes-get` — Get a process by ID.
181- `azure-devops-pp-cli apis processes-list` — Get a list of processes.
182- `azure-devops-pp-cli apis projects-create` — Queues a project to be created. Use the [GetOperation](../..
183- `azure-devops-pp-cli apis projects-delete` — Queues a project to be deleted. Use the [GetOperation](../..
184- `azure-devops-pp-cli apis projects-get` — Get project with the specified id or name, optionally including capabilities.
185- `azure-devops-pp-cli apis projects-get-project-properties` — Get a collection of team project properties.
186- `azure-devops-pp-cli apis projects-list` — Get all projects in the organization that the authenticated user has access to.
187- `azure-devops-pp-cli apis projects-set-project-properties` — Create, update, and delete team project properties.
188- `azure-devops-pp-cli apis projects-update` — Update an existing project's name, abbreviation, description, or restore a project.
189- `azure-devops-pp-cli apis teams-create` — Create a team in a team project.
190- `azure-devops-pp-cli apis teams-delete` — Delete a team.
191- `azure-devops-pp-cli apis teams-get` — Get a specific team.
192- `azure-devops-pp-cli apis teams-get-all-teams` — Get a list of all teams.
193- `azure-devops-pp-cli apis teams-get-team-members-with-extended-properties` — Get a list of members for a specific team.
194- `azure-devops-pp-cli apis teams-get-teams` — Get a list of teams.
195- `azure-devops-pp-cli apis teams-update` — Update a team's name and/or description.
196
197**build-apis** — Manage build apis
198
199- `azure-devops-pp-cli build-apis artifacts-create` — Associates an artifact with a build.
200- `azure-devops-pp-cli build-apis artifacts-list` — Gets all artifacts for a build.
201- `azure-devops-pp-cli build-apis attachments-get` — Gets a specific attachment.
202- `azure-devops-pp-cli build-apis attachments-list` — Gets the list of attachments of a specific type that are associated with a build.
203- `azure-devops-pp-cli build-apis authorizedresources-authorize-project-resources` — Authorizedresources authorize project resources
204- `azure-devops-pp-cli build-apis authorizedresources-list` — Authorizedresources list
205- `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.
206- `azure-devops-pp-cli build-apis builds-delete` — Deletes a build.
207- `azure-devops-pp-cli build-apis builds-get` — Gets a build
208- `azure-devops-pp-cli build-apis builds-get-build-changes` — Gets the changes associated with a build
209- `azure-devops-pp-cli build-apis builds-get-build-log` — Gets an individual log file for a build.
210- `azure-devops-pp-cli build-apis builds-get-build-logs` — Gets the logs for a build.
211- `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.
212- `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.
213- `azure-devops-pp-cli build-apis builds-get-changes-between-builds` — Gets the changes made to the repository between two given builds.
214- `azure-devops-pp-cli build-apis builds-get-retention-leases-for-build` — Gets all retention leases that apply to a specific build.
215- `azure-devops-pp-cli build-apis builds-get-work-items-between-builds` — Gets all the work items between two builds.
216- `azure-devops-pp-cli build-apis builds-list` — Gets a list of builds.
217- `azure-devops-pp-cli build-apis builds-queue` — Queues a build
218- `azure-devops-pp-cli build-apis builds-update-build` — Updates a build.
219- `azure-devops-pp-cli build-apis builds-update-builds` — Updates multiple builds.
220- `azure-devops-pp-cli build-apis definitions-create` — Creates a new definition.
221- `azure-devops-pp-cli build-apis definitions-delete` — Deletes a definition and all associated builds.
222- `azure-devops-pp-cli build-apis definitions-get` — Gets a definition, optionally at a specific revision.
223- `azure-devops-pp-cli build-apis definitions-get-definition-revisions` — Gets all revisions of a definition.
224- `azure-devops-pp-cli build-apis definitions-list` — Gets a list of definitions.
225- `azure-devops-pp-cli build-apis definitions-restore-definition` — Restores a deleted definition
226- `azure-devops-pp-cli build-apis definitions-update` — Updates an existing build definition.
227- `azure-devops-pp-cli build-apis folders-create` — Creates a new folder.
228- `azure-devops-pp-cli build-apis folders-delete` — Deletes a definition folder. Definitions and their corresponding builds will also be deleted.
229- `azure-devops-pp-cli build-apis folders-list` — Gets a list of build definition folders.
230- `azure-devops-pp-cli build-apis folders-update` — Updates an existing folder at given existing path
231- `azure-devops-pp-cli build-apis general-settings-get` — Gets pipeline general settings.
232- `azure-devops-pp-cli build-apis general-settings-update` — Updates pipeline general settings.
233- `azure-devops-pp-cli build-apis latest-get` — Gets the latest build for a definition, optionally scoped to a specific branch.
234- `azure-devops-pp-cli build-apis leases-add` — Adds new leases for pipeline runs.
235- `azure-devops-pp-cli build-apis leases-delete` — Removes specific retention leases.
236- `azure-devops-pp-cli build-apis leases-get` — Returns the details of the retention lease given a lease id.
237- `azure-devops-pp-cli build-apis leases-get-retention-leases-by-minimal-retention-leases` — Returns any leases matching the specified MinimalRetentionLeases
238- `azure-devops-pp-cli build-apis leases-update` — Updates the duration or pipeline protection status of a retention lease.
239- `azure-devops-pp-cli build-apis metrics-get-definition-metrics` — Gets build metrics for a definition.
240- `azure-devops-pp-cli build-apis metrics-get-project-metrics` — Gets build metrics for a project.
241- `azure-devops-pp-cli build-apis options-list` — Gets all build definition options supported by the system.
242- `azure-devops-pp-cli build-apis properties-get-build-properties` — Gets properties for a build.
243- `azure-devops-pp-cli build-apis properties-get-definition-properties` — Gets properties for a definition.
244- `azure-devops-pp-cli build-apis properties-update-build-properties` — Updates properties for a build.
245- `azure-devops-pp-cli build-apis properties-update-definition-properties` — Updates properties for a definition.
246- `azure-devops-pp-cli build-apis report-get` — Gets a build report.
247- `azure-devops-pp-cli build-apis resources-authorize-definition-resources` — Resources authorize definition resources
248- `azure-devops-pp-cli build-apis resources-list` — Resources list
249- `azure-devops-pp-cli build-apis retention-get` — Gets the project's retention settings.
250- `azure-devops-pp-cli build-apis retention-update` — Updates the project's retention settings.
251- `azure-devops-pp-cli build-apis settings-get` — Gets the build settings.
252- `azure-devops-pp-cli build-apis settings-update` — Updates the build settings.
253- `azure-devops-pp-cli build-apis source-providers-get-file-contents` — Gets the contents of a file in the given source code repository.
254- `azure-devops-pp-cli build-apis source-providers-get-path-contents` — Gets the contents of a directory in the given source code repository.
255- `azure-devops-pp-cli build-apis source-providers-get-pull-request` — Gets a pull request object from source provider.
256- `azure-devops-pp-cli build-apis source-providers-list` — Get a list of source providers and their capabilities.
257- `azure-devops-pp-cli build-apis source-providers-list-branches` — Gets a list of branches for the given source code repository.
258- `azure-devops-pp-cli build-apis source-providers-list-repositories` — Gets a list of source code repositories.
259- `azure-devops-pp-cli build-apis source-providers-list-webhooks` — Gets a list of webhooks installed in the given source code repository.
260- `azure-devops-pp-cli build-apis source-providers-restore-webhooks` — Recreates the webhooks for the specified triggers in the given source code repository.
261- `azure-devops-pp-cli build-apis stages-update` — Update a build stage
262- `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.
263- `azure-devops-pp-cli build-apis tags-add-build-tag` — Adds a tag to a build.
264- `azure-devops-pp-cli build-apis tags-add-build-tags` — Adds tags to a build.
265- `azure-devops-pp-cli build-apis tags-add-definition-tag` — Adds a tag to a definition
266- `azure-devops-pp-cli build-apis tags-add-definition-tags` — Adds multiple tags to a definition.
267- `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.
268- `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.
269- `azure-devops-pp-cli build-apis tags-delete-tag` — Removes a tag from builds, definitions, and from the tag store
270- `azure-devops-pp-cli build-apis tags-get-build-tags` — Gets the tags for a build.
271- `azure-devops-pp-cli build-apis tags-get-definition-tags` — Gets the tags for a definition.
272- `azure-devops-pp-cli build-apis tags-get-tags` — Gets a list of all build tags in the project.
273- `azure-devops-pp-cli build-apis tags-update-build-tags` — Adds/Removes tags from a build.
274- `azure-devops-pp-cli build-apis tags-update-definition-tags` — Adds/Removes tags from a definition.
275- `azure-devops-pp-cli build-apis templates-delete` — Deletes a build definition template.
276- `azure-devops-pp-cli build-apis templates-get` — Gets a specific build definition template.
277- `azure-devops-pp-cli build-apis templates-list` — Gets all definition templates.
278- `azure-devops-pp-cli build-apis templates-save-template` — Updates an existing build definition template.
279- `azure-devops-pp-cli build-apis timeline-get` — Gets details for a build
280- `azure-devops-pp-cli build-apis yaml-get` — Converts a definition to YAML, optionally at a specific revision.
281
282**git-apis** — Manage git apis
283
284- `azure-devops-pp-cli git-apis annotated-tags-create` — Create an annotated tag. Repositories have both a name and an identifier.
285- `azure-devops-pp-cli git-apis annotated-tags-get` — Get an annotated tag. Repositories have both a name and an identifier.
286- `azure-devops-pp-cli git-apis blobs-get-blob` — Get a single blob. Repositories have both a name and an identifier.
287- `azure-devops-pp-cli git-apis blobs-get-blobs-zip` — Gets one or more blobs in a zip file download.
288- `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.
289- `azure-devops-pp-cli git-apis cherry-picks-get-cherry-pick` — Retrieve information about a cherry pick operation by cherry pick Id.
290- `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.
291- `azure-devops-pp-cli git-apis commits-get` — Retrieve a particular commit.
292- `azure-devops-pp-cli git-apis commits-get-changes` — Retrieve changes for a particular commit.
293- `azure-devops-pp-cli git-apis commits-get-commits-batch` — Retrieve git commits for a project matching the search criteria
294- `azure-devops-pp-cli git-apis commits-get-push-commits` — Retrieve a list of commits associated with a particular push.
295- `azure-devops-pp-cli git-apis diffs-get` — Find the closest common commit (the merge base) between base and target commits
296- `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.
297- `azure-devops-pp-cli git-apis forks-get-fork-sync-request` — Get a specific fork sync operation's details.
298- `azure-devops-pp-cli git-apis forks-get-fork-sync-requests` — Retrieve all requested fork sync operations on this repository.
299- `azure-devops-pp-cli git-apis forks-list` — Retrieve all forks of a repository in the collection.
300- `azure-devops-pp-cli git-apis import-requests-create` — Create an import request.
301- `azure-devops-pp-cli git-apis import-requests-get` — Retrieve a particular import request.
302- `azure-devops-pp-cli git-apis import-requests-query` — Retrieve import requests for a repository.
303- `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.
304- `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
305- `azure-devops-pp-cli git-apis items-list` — Get Item Metadata and/or Content for a collection of items.
306- `azure-devops-pp-cli git-apis merge-bases-list` — Find the merge bases of two commits, optionally across forks.
307- `azure-devops-pp-cli git-apis merges-create` — Request a git merge operation. Currently we support merging only 2 commits.
308- `azure-devops-pp-cli git-apis merges-get` — Get a specific merge operation's details.
309- `azure-devops-pp-cli git-apis policy-configurations-get` — Retrieve a list of policy configurations by a given set of scope/filtering criteria.
310- `azure-devops-pp-cli git-apis pull-request-attachments-create` — Attach a new file to a pull request.
311- `azure-devops-pp-cli git-apis pull-request-attachments-delete` — Delete a pull request attachment.
312- `azure-devops-pp-cli git-apis pull-request-attachments-get` — Get the file content of a pull request attachment.
313- `azure-devops-pp-cli git-apis pull-request-attachments-list` — Get a list of files attached to a given pull request.
314- `azure-devops-pp-cli git-apis pull-request-comment-likes-create` — Add a like on a comment.
315- `azure-devops-pp-cli git-apis pull-request-comment-likes-delete` — Delete a like on a comment.
316- `azure-devops-pp-cli git-apis pull-request-comment-likes-list` — Get likes for a comment.
317- `azure-devops-pp-cli git-apis pull-request-commits-get-pull-request-commits` — Get the commits for the specified pull request.
318- `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.
319- `azure-devops-pp-cli git-apis pull-request-iteration-changes-get` — Retrieve the changes made in a pull request between two iterations.
320- `azure-devops-pp-cli git-apis pull-request-iteration-statuses-create` — Create a pull request status on the iteration.
321- `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.
322- `azure-devops-pp-cli git-apis pull-request-iteration-statuses-get` — Get the specific pull request iteration status by ID.
323- `azure-devops-pp-cli git-apis pull-request-iteration-statuses-list` — Get all the statuses associated with a pull request iteration.
324- `azure-devops-pp-cli git-apis pull-request-iteration-statuses-update` — Update pull request iteration statuses collection. The only supported operation type is `remove`.
325- `azure-devops-pp-cli git-apis pull-request-iterations-get` — Get the specified iteration for a pull request.
326- `azure-devops-pp-cli git-apis pull-request-iterations-list` — Get the list of iterations for the specified pull request.
327- `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.
328- `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.
329- `azure-devops-pp-cli git-apis pull-request-labels-get` — Retrieves a single label (tag) that has been assigned to a pull request.
330- `azure-devops-pp-cli git-apis pull-request-labels-list` — Get all the labels (tags) assigned to a pull request.
331- `azure-devops-pp-cli git-apis pull-request-properties-list` — Get external properties of the pull request.
332- `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`.
333- `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.
334- `azure-devops-pp-cli git-apis pull-request-reviewers-create-pull-request-reviewer` — Add a reviewer to a pull request or cast a vote.
335- `azure-devops-pp-cli git-apis pull-request-reviewers-create-pull-request-reviewers` — Add reviewers to a pull request.
336- `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.
337- `azure-devops-pp-cli git-apis pull-request-reviewers-delete` — Remove a reviewer from a pull request.
338- `azure-devops-pp-cli git-apis pull-request-reviewers-get` — Retrieve information about a particular reviewer on a pull request
339- `azure-devops-pp-cli git-apis pull-request-reviewers-list` — Retrieve the reviewers for a pull request
340- `azure-devops-pp-cli git-apis pull-request-reviewers-update-pull-request-reviewer` — Edit a reviewer entry. These fields are patchable: isFlagged, hasDeclined
341- `azure-devops-pp-cli git-apis pull-request-reviewers-update-pull-request-reviewers` — Reset the votes of multiple reviewers on a pull request.
342- `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
343- `azure-devops-pp-cli git-apis pull-request-statuses-create` — Create a pull request status. The only required field for the status is `Context.
344- `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.
345- `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.
346- `azure-devops-pp-cli git-apis pull-request-statuses-list` — Get all the statuses associated with a pull request.
347- `azure-devops-pp-cli git-apis pull-request-statuses-update` — Update pull request statuses collection. The only supported operation type is `remove`.
348- `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).
349- `azure-devops-pp-cli git-apis pull-request-thread-comments-delete` — Delete a comment associated with a specific thread in a pull request.
350- `azure-devops-pp-cli git-apis pull-request-thread-comments-get` — Retrieve a comment associated with a specific thread in a pull request.
351- `azure-devops-pp-cli git-apis pull-request-thread-comments-list` — Retrieve all comments associated with a specific thread in a pull request.
352- `azure-devops-pp-cli git-apis pull-request-thread-comments-update` — Update a comment associated with a specific thread in a pull request.
353- `azure-devops-pp-cli git-apis pull-request-threads-create` — Create a thread in a pull request.
354- `azure-devops-pp-cli git-apis pull-request-threads-get` — Retrieve a thread in a pull request.
355- `azure-devops-pp-cli git-apis pull-request-threads-list` — Retrieve all threads in a pull request.
356- `azure-devops-pp-cli git-apis pull-request-threads-update` — Update a thread in a pull request.
357- `azure-devops-pp-cli git-apis pull-request-work-items-list` — Retrieve a list of work items associated with a pull request.
358- `azure-devops-pp-cli git-apis pull-requests-create` — Create a pull request.
359- `azure-devops-pp-cli git-apis pull-requests-get-pull-request` — Retrieve a pull request.
360- `azure-devops-pp-cli git-apis pull-requests-get-pull-request-by-id` — Retrieve a pull request.
361- `azure-devops-pp-cli git-apis pull-requests-get-pull-requests` — Retrieve all pull requests matching a specified criteria.
362- `azure-devops-pp-cli git-apis pull-requests-get-pull-requests-by-project` — Retrieve all pull requests matching a specified criteria.
363- `azure-devops-pp-cli git-apis pull-requests-update` — Update a pull request These are the properties that can be updated with the API
364- `azure-devops-pp-cli git-apis pushes-create` — Push changes to the repository.
365- `azure-devops-pp-cli git-apis pushes-get` — Retrieves a particular push.
366- `azure-devops-pp-cli git-apis pushes-list` — Retrieves pushes associated with the specified repository.
367- `azure-devops-pp-cli git-apis refs-favorites-create` — Creates a ref favorite
368- `azure-devops-pp-cli git-apis refs-favorites-delete` — Deletes the refs favorite specified
369- `azure-devops-pp-cli git-apis refs-favorites-get` — Gets the refs favorite for a favorite Id.
370- `azure-devops-pp-cli git-apis refs-favorites-list` — Gets the refs favorites for a repo and an identity.
371- `azure-devops-pp-cli git-apis refs-list` — Queries the provided repository for its refs and returns them.
372- `azure-devops-pp-cli git-apis refs-update-ref` — Lock or Unlock a branch.
373- `azure-devops-pp-cli git-apis refs-update-refs` — Creating, updating, or deleting refs(branches).
374- `azure-devops-pp-cli git-apis repositories-create` — Create a git repository in a team project.
375- `azure-devops-pp-cli git-apis repositories-delete` — Delete a git repository
376- `azure-devops-pp-cli git-apis repositories-delete-repository-from-recycle-bin` — Destroy (hard delete) a soft-deleted Git repository.
377- `azure-devops-pp-cli git-apis repositories-get-deleted-repositories` — Retrieve deleted git repositories.
378- `azure-devops-pp-cli git-apis repositories-get-recycle-bin-repositories` — Retrieve soft-deleted git repositories from the recycle bin.
379- `azure-devops-pp-cli git-apis repositories-get-repository` — Retrieve a git repository.
380- `azure-devops-pp-cli git-apis repositories-list` — Retrieve git repositories.
381- `azure-devops-pp-cli git-apis repositories-restore-repository-from-recycle-bin` — Recover a soft-deleted Git repository.
382- `azure-devops-pp-cli git-apis repositories-update` — Updates the Git repository with either a new repo name or a new default branch.
383- `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
384- `azure-devops-pp-cli git-apis reverts-get-revert` — Retrieve information about a revert operation by revert Id.
385- `azure-devops-pp-cli git-apis reverts-get-revert-for-ref-name` — Retrieve information about a revert operation for a specific branch.
386- `azure-devops-pp-cli git-apis stats-list` — Retrieve statistics about all branches within a repository.
387- `azure-devops-pp-cli git-apis statuses-create` — Create Git commit status.
388- `azure-devops-pp-cli git-apis statuses-list` — Get statuses associated with the Git commit.
389- `azure-devops-pp-cli git-apis suggestions-list` — Retrieve a pull request suggestion for a particular repository or team project.
390- `azure-devops-pp-cli git-apis trees-get` — The Tree endpoint returns the collection of objects underneath the specified tree.
391
392**pipelines-apis** — Manage pipelines apis
393
394- `azure-devops-pp-cli pipelines-apis artifacts-get` — Get a specific artifact from a pipeline run
395- `azure-devops-pp-cli pipelines-apis logs-get` — Get a specific log from a pipeline run
396- `azure-devops-pp-cli pipelines-apis logs-list` — Get a list of logs from a pipeline run.
397- `azure-devops-pp-cli pipelines-apis pipelines-create` — Create a pipeline.
398- `azure-devops-pp-cli pipelines-apis pipelines-get` — Gets a pipeline, optionally at the specified version
399- `azure-devops-pp-cli pipelines-apis pipelines-list` — Get a list of pipelines.
400- `azure-devops-pp-cli pipelines-apis preview-preview` — Queues a dry run of the pipeline and returns an object containing the final yaml.
401- `azure-devops-pp-cli pipelines-apis runs-get` — Gets a run for a particular pipeline.
402- `azure-devops-pp-cli pipelines-apis runs-list` — Gets top 10000 runs for a particular pipeline.
403- `azure-devops-pp-cli pipelines-apis runs-run-pipeline` — Runs a pipeline.
404
405**release-apis** — Manage release apis
406
407- `azure-devops-pp-cli release-apis approvals-list` — Get a list of approvals
408- `azure-devops-pp-cli release-apis approvals-update` — Update status of an approval
409- `azure-devops-pp-cli release-apis attachments-get-release-task-attachment-content` — Get a release task attachment.
410- `azure-devops-pp-cli release-apis attachments-get-release-task-attachments` — Get the release task attachments.
411- `azure-devops-pp-cli release-apis attachments-get-task-attachment-content` — GetTaskAttachmentContent API is deprecated. Use GetReleaseTaskAttachmentContent API instead.
412- `azure-devops-pp-cli release-apis attachments-get-task-attachments` — GetTaskAttachments API is deprecated. Use GetReleaseTaskAttachments API instead.
413- `azure-devops-pp-cli release-apis definitions-create` — Create a release definition
414- `azure-devops-pp-cli release-apis definitions-delete` — Delete a release definition.
415- `azure-devops-pp-cli release-apis definitions-get` — Get a release definition.
416- `azure-devops-pp-cli release-apis definitions-get-definition-revision` — Get release definition for a given definitionId and revision
417- `azure-devops-pp-cli release-apis definitions-get-release-definition-history` — Get revision history for a release definition
418- `azure-devops-pp-cli release-apis definitions-list` — Get a list of release definitions.
419- `azure-devops-pp-cli release-apis definitions-update` — Update a release definition.
420- `azure-devops-pp-cli release-apis deployments-list` — Deployments list
421- `azure-devops-pp-cli release-apis folders-create` — This method is no longer supported. Use CreateFolder with folder parameter API.
422- `azure-devops-pp-cli release-apis folders-delete` — Deletes a definition folder for given folder name and path and all it's existing definitions.
423- `azure-devops-pp-cli release-apis folders-list` — Gets folders.
424- `azure-devops-pp-cli release-apis folders-update` — Updates an existing folder at given existing path.
425- `azure-devops-pp-cli release-apis gates-update` — Updates the gate for a deployment.
426- `azure-devops-pp-cli release-apis manual-interventions-get` — Get manual intervention for a given release and manual intervention id.
427- `azure-devops-pp-cli release-apis manual-interventions-list` — List all manual interventions for a given release.
428- `azure-devops-pp-cli release-apis manual-interventions-update` — Update manual intervention.
429- `azure-devops-pp-cli release-apis releases-create` — Create a release.
430- `azure-devops-pp-cli release-apis releases-get-logs` — Get logs for a release Id.
431- `azure-devops-pp-cli release-apis releases-get-release-environment` — Get a release environment.
432- `azure-devops-pp-cli release-apis releases-get-release-revision` — Get release for a given revision number.
433- `azure-devops-pp-cli release-apis releases-get-task-log` — Gets the task log of a release as a plain text file.
434- `azure-devops-pp-cli release-apis releases-list` — Get a list of releases
435- `azure-devops-pp-cli release-apis releases-update-release` — Update a complete release object.
436- `azure-devops-pp-cli release-apis releases-update-release-environment` — Update the status of a release environment
437- `azure-devops-pp-cli release-apis releases-update-release-resource` — Update few properties of a release.
438
439**search-apis** — Manage search apis
440
441- `azure-devops-pp-cli search-apis <organization>` — Provides a set of results for the search text.
442
443**wiki-apis** — Manage wiki apis
444
445- `azure-devops-pp-cli wiki-apis attachments-create` — Creates an attachment in the wiki.
446- `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.
447- `azure-devops-pp-cli wiki-apis page-stats-get` — Returns page detail corresponding to Page ID.
448- `azure-devops-pp-cli wiki-apis pages-batch-get` — Returns pageable list of Wiki Pages
449- `azure-devops-pp-cli wiki-apis pages-create-or-update` — Creates or edits a wiki page.
450- `azure-devops-pp-cli wiki-apis pages-delete-page` — Deletes a wiki page.
451- `azure-devops-pp-cli wiki-apis pages-delete-page-by-id` — Deletes a wiki page.
452- `azure-devops-pp-cli wiki-apis pages-get-page` — Gets metadata or content of the wiki page for the provided path.
453- `azure-devops-pp-cli wiki-apis pages-get-page-by-id` — Gets metadata or content of the wiki page for the provided page id.
454- `azure-devops-pp-cli wiki-apis pages-update` — Edits a wiki page.
455- `azure-devops-pp-cli wiki-apis wikis-create` — Creates the wiki resource.
456- `azure-devops-pp-cli wiki-apis wikis-delete` — Deletes the wiki corresponding to the wiki ID or wiki name provided.
457- `azure-devops-pp-cli wiki-apis wikis-get` — Gets the wiki corresponding to the wiki ID or wiki name provided.
458- `azure-devops-pp-cli wiki-apis wikis-list` — Gets all wikis in a project or collection.
459- `azure-devops-pp-cli wiki-apis wikis-update` — Updates the wiki corresponding to the wiki ID or wiki name provided using the update parameters.
460
461**work-apis** — Manage work apis
462
463- `azure-devops-pp-cli work-apis boardcolumns-list` — Get available board columns in a project
464- `azure-devops-pp-cli work-apis boardrows-list` — Get available board rows in a project
465- `azure-devops-pp-cli work-apis deliverytimeline-get` — Get Delivery View Data
466- `azure-devops-pp-cli work-apis iterationcapacities-get` — Get an iteration's capacity for all teams in iteration
467- `azure-devops-pp-cli work-apis plans-create` — Add a new plan for the team
468- `azure-devops-pp-cli work-apis plans-delete` — Delete the specified plan
469- `azure-devops-pp-cli work-apis plans-get` — Get the information for the specified plan
470- `azure-devops-pp-cli work-apis plans-list` — Get the information for all the plans configured for the given team
471- `azure-devops-pp-cli work-apis plans-update` — Update the information for the specified plan
472- `azure-devops-pp-cli work-apis processconfiguration-get` — Get process configuration
473
474**workitemtracking-apis** — Manage workitemtracking apis
475
476- `azure-devops-pp-cli workitemtracking-apis account-my-work-recent-activity-list` — Gets recent work item activities
477- `azure-devops-pp-cli workitemtracking-apis artifact-link-types-list` — Get the list of work item tracking outbound artifact link types.
478- `azure-devops-pp-cli workitemtracking-apis work-item-icons-get` — Get a work item icon given the friendly name and icon color.
479- `azure-devops-pp-cli workitemtracking-apis work-item-icons-list` — Get a list of all work item icons.
480- `azure-devops-pp-cli workitemtracking-apis work-item-relation-types-get` — Gets the work item relation type definition.
481- `azure-devops-pp-cli workitemtracking-apis work-item-relation-types-list` — Gets the work item relation types.
482- `azure-devops-pp-cli workitemtracking-apis work-item-transitions-list` — Returns the next state on the given work item IDs.
483
484
485### Finding the right command
486
487When you know what you want to do but not which command does it, ask the CLI directly:
488
489```bash
490azure-devops-pp-cli which "<capability in your own words>"
491```
492
493`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` means no confident match — fall back to `--help` or use a narrower query.
494
495## Recipes
496
497### Morning standup in one command
498
499```bash
500azure-devops-pp-cli standup --agent --select myPRs,myWorkItems,failedBuilds
501```
502
503Returns your daily briefing as structured JSON: PRs waiting for your review, work items in progress, and builds that failed since yesterday.
504
505### Find PRs ready for your review
506
507```bash
508azure-devops-pp-cli pr review-queue --agent --select title,repo,buildStatus,waitingReviewers
509```
510
511Shows only PRs where you are required, the build is green, and no other required reviewer has voted — ordered by most ready first.
512
513### Sprint velocity trend for capacity planning
514
515```bash
516azure-devops-pp-cli velocity --sprints 8 --team ENG --agent --select sprint,committed,completed,velocityPoints
517```
518
519Returns 8-sprint velocity history as structured JSON for an agent to compute averages and forecast next sprint capacity.
520
521### Scope creep check at sprint mid-point
522
523```bash
524azure-devops-pp-cli work sprint-creep --team ENG --agent --select addedItems,addedPoints,percentCreep
525```
526
527Shows what was added to the current sprint after it started, with story points and percentage of total sprint scope that crept in.
528
529### Cross-repo health before a release
530
531```bash
532azure-devops-pp-cli git branch-health --agent --select repo,buildStatus,lastCommitDays,openPRs
533```
534
535One-line summary of all repos: default branch build status, days since last commit, and open PR count — to confirm everything is green before a release.
536
537## Auth Setup
538
539Set AZURE_DEVOPS_TOKEN to a Personal Access Token. Generate one at dev.azure.com/{org}/_usersSettings/tokens with scopes: Work Items (read/write), Code (read), Build (read), Release (read/execute). Run `azure-devops-pp-cli auth setup --launch` to open the token page. Save with `azure-devops-pp-cli auth set-token <your-pat>`.
540
541Run `azure-devops-pp-cli doctor` to verify setup.
542
543## Agent Mode
544
545Add `--agent` to any command. Expands to: `--json --compact --no-input --no-color --yes`.
546
547- **Pipeable** — JSON on stdout, errors on stderr
548- **Filterable** — `--select` keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
549
550 ```bash
551 azure-devops-pp-cli apis avatar-remove-project-avatar mock-value mock-value --api-version example-value --agent --select id,name,status
552 ```
553- **Previewable** — `--dry-run` shows the request without sending
554- **Offline-friendly** — sync/search commands can use the local SQLite store when available
555- **Non-interactive** — never prompts, every input is a flag
556- **Explicit retries** — use `--idempotent` only when an already-existing create should count as success, and `--ignore-missing` only when a missing delete target should count as success
557
558### Response envelope
559
560Commands that read from the local store or the API wrap output in a provenance envelope:
561
562```json
563{
564 "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
565 "results": <data>
566}
567```
568
569Parse `.results` for data and `.meta.source` to know whether it's live or local. A human-readable `N results (live)` summary is printed to stderr only when stdout is a terminal AND no machine-format flag (`--json`, `--csv`, `--compact`, `--quiet`, `--plain`, `--select`) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.
570
571## Agent Feedback
572
573When you (or the agent) notice something off about this CLI, record it:
574
575```
576azure-devops-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
577azure-devops-pp-cli feedback --stdin < notes.txt
578azure-devops-pp-cli feedback list --json --limit 10
579```
580
581Entries are stored locally at `~/.local/share/azure-devops-pp-cli/feedback.jsonl`. They are never POSTed unless `AZURE_DEVOPS_FEEDBACK_ENDPOINT` is set AND either `--send` is passed or `AZURE_DEVOPS_FEEDBACK_AUTO_SEND=true`. Default behavior is local-only.
582
583Write what *surprised* you, not a bug report. Short, specific, one line: that is the part that compounds.
584
585## Output Delivery
586
587Every command accepts `--deliver <sink>`. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
588
589| Sink | Effect |
590|------|--------|
591| `stdout` | Default; write to stdout only |
592| `file:<path>` | Atomically write output to `<path>` (tmp + rename) |
593| `webhook:<url>` | POST the output body to the URL (`application/json` or `application/x-ndjson` when `--compact`) |
594
595Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
596
597## Named Profiles
598
599A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
600
601```
602azure-devops-pp-cli profile save briefing --json
603azure-devops-pp-cli --profile briefing apis avatar-remove-project-avatar mock-value mock-value --api-version example-value
604azure-devops-pp-cli profile list --json
605azure-devops-pp-cli profile show briefing
606azure-devops-pp-cli profile delete briefing --yes
607```
608
609Explicit flags always win over profile values; profile values win over defaults. `agent-context` lists all available profiles under `available_profiles` so introspecting agents discover them at runtime.
610
611## Async Jobs
612
613For endpoints that submit long-running work, the generator detects the submit-then-poll pattern (a `job_id`/`task_id`/`operation_id` field in the response plus a sibling status endpoint) and wires up three extra flags on the submitting command:
614
615| Flag | Purpose |
616|------|---------|
617| `--wait` | Block until the job reaches a terminal status instead of returning the job ID immediately |
618| `--wait-timeout` | Maximum wait duration (default 10m, 0 means no timeout) |
619| `--wait-interval` | Initial poll interval (default 2s; grows with exponential backoff up to 30s) |
620
621Use async submission without `--wait` when you want to fire-and-forget; use `--wait` when you want one command to return the finished artifact.
622
623## Exit Codes
624
625| Code | Meaning |
626|------|---------|
627| 0 | Success |
628| 2 | Usage error (wrong arguments) |
629| 3 | Resource not found |
630| 4 | Authentication required |
631| 5 | API error (upstream issue) |
632| 7 | Rate limited (wait and retry) |
633| 10 | Config error |
634
635## Argument Parsing
636
637Parse `$ARGUMENTS`:
638
6391. **Empty, `help`, or `--help`** → show `azure-devops-pp-cli --help` output
6402. **Starts with `install`** → ends with `mcp` → MCP installation; otherwise → see Prerequisites above
6413. **Anything else** → Direct Use (execute as CLI command with `--agent`)
642
643## MCP Server Installation
644
6451. Install the MCP server:
646 ```bash
647 go install github.com/mvanhorn/printing-press-library/library/developer-tools/azure-devops/cmd/azure-devops-pp-mcp@latest
648 ```
6492. Register with Claude Code:
650 ```bash
651 claude mcp add azure-devops-pp-mcp -- azure-devops-pp-mcp
652 ```
6533. Verify: `claude mcp list`
654
655## Direct Use
656
6571. Check if installed: `which azure-devops-pp-cli`
658 If not found, offer to install (see Prerequisites at the top of this skill).
6592. Match the user query to the best command from the Unique Capabilities and Command Reference above.
6603. Execute with the `--agent` flag:
661 ```bash
662 azure-devops-pp-cli <command> [subcommand] [args] --agent
663 ```
6644. If ambiguous, drill into subcommand help: `azure-devops-pp-cli <command> --help`.