AzDo 1.0.2

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet tool install --global AzDo --version 1.0.2
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local AzDo --version 1.0.2
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=AzDo&version=1.0.2
                    


                    

                
nuke :add-package AzDo --version 1.0.2

azdo — Command Reference

Version: 0.3.0 | Package: AzDo | Tool: dotnet tool install -g AzDo

All commands support --org and --project overrides (optional — auto-detected from git remote).

📋 CLI Commands

Context

Command Description
azdo context Detect Azure DevOps org/project/repo from the current git remote

Configuration

Command Description
azdo config list List all configured organizations
azdo config add --org X --pat <token> Register an organization
azdo config remove --org X Remove an organization
azdo config path Show the config file path

Work Items

Command Description
azdo wi query --wiql "SELECT ..." [--top 10] Run a WIQL query
azdo wi get --ids 1,2,3 [--fields System.Title,System.State] Get work items by ID
azdo wi create --type Task --title "..." [--description "..."] [--assigned-to me@eng.it] [--parent 1234] [--iteration "MyProject\\Sprint 1"] Create a work item
azdo wi update --id 1234 [--state Active] [--title "..."] [--assigned-to me@eng.it] Update a work item
azdo wi comment --id 1234 --text "..." Add a comment to a work item

Repositories & Git

Command Description
azdo repo list [--top 20] [--skip 10] List repositories
azdo repo branches --repo X [--search feature] [--top 20] List branches in a repository
azdo repo commits --repo X [--branch main] [--author me@eng.it] [--since 2026-01-01] [--until 2026-06-01] [--top 50] [--skip 0] List commits in a repository
azdo repo diff --repo X --base main --target feature/foo Get diff between two commits or branches
azdo repo file --repo X --path src/Program.cs [--ref main] Get file content from a repository

Pull Requests

Command Description
azdo pr list [--repo X] [--status active] [--creator me@eng.it] [--top 20] [--skip 0] List pull requests
azdo pr create --title "..." [--repo X] [--source feature/foo] [--target main] [--description "..."] [--draft] [--work-item 1234] [--reviewer <guid>] Create a pull request
azdo pr vote --pr 1234 [--repo X] --voter-id <guid> [--vote 10] Vote on a pull request (10=approve, 5=suggestions, 0=reset, -5=waiting, -10=reject)
azdo pr abandon --pr 1234 [--repo X] Abandon a pull request
azdo pr complete --pr 1234 [--repo X] [--delete-source] Complete a pull request
azdo pr detail --pr 1234 [--repo X] Show PR details with reviewers, votes, and merge status
azdo pr threads --pr 1234 [--repo X] List review threads on a pull request
azdo pr comment --pr 1234 --text "..." [--repo X] [--file src/Foo.cs --line 42] Add a comment to a pull request (use --file and --line for inline comments)

Builds & Pipelines

Command Description
azdo build list [--top 20] [--definition 5] List recent builds
azdo build status --id 1234 Get build status and timeline
azdo build trigger --definition 5 [--branch refs/heads/main] Trigger a pipeline run

MCP Server

Command Description
azdo mcp serve [--transport stdio\|http] [--port 9287] Start the MCP server
azdo mcp list-tools List all available MCP tools as JSON

🔌 MCP Tools (22 total)

Use these in Claude Desktop, Copilot, Cursor, or any MCP-compatible agent.

Context

Tool Args Description
azdo_context (none) Detect org/project/repo from git remote

Work Items

Tool Required Args Optional Args Description
azdo_wi_query wiql top, compact, org, project Run a WIQL query
azdo_wi_get ids fields, compact, org, project Get work items by ID
azdo_wi_create type, title description, assignedTo, parent, iteration, org, project Create a work item
azdo_wi_update id state, title, assignedTo, parent, iteration, org, project Update a work item
azdo_wi_comment id, text org, project Add a comment to a work item

Repositories & Git

Tool Required Args Optional Args Description
azdo_repo_list (none) top, skip, compact, org, project List repositories
azdo_git_branches repo search, top, compact, org, project List branches in a repository
azdo_git_commits repo branch, author, from, to, top, skip, compact, org, project List commits in a repository
azdo_git_diff repo, base, target org, project Get diff between two commits/branches
azdo_git_file repo, path ref, org, project Get file content from a repository

Pull Requests

Tool Required Args Optional Args Description
azdo_pr_list (none) repo, status, creator, top, skip, compact, org, project List pull requests
azdo_pr_create title repo, source, target, description, draft, workItems, reviewers, org, project Create a pull request
azdo_pr_vote prId, repo, voterId, vote org, project Vote on a PR (10=approve, 5=suggestions, 0=reset, -5=waiting, -10=reject)
azdo_pr_update prId, repo status, title, autoComplete, deleteSourceBranch, org, project Update PR status or set auto-complete
azdo_pr_detail prId, repo org, project Get PR detail with reviewers, votes, merge status
azdo_pr_threads prId, repo compact, org, project List review threads on a PR
azdo_pr_comment prId, repo, content threadId, file, line, org, project Add a comment to a PR thread
azdo_pr_resolve prId, repo, threadId org, project Resolve a review thread

Builds & Pipelines

Tool Required Args Optional Args Description
azdo_build_list (none) top, definition, compact, org, project List recent builds
azdo_build_status id compact, org, project Get build status and timeline
azdo_build_trigger definition branch, org, project Trigger a pipeline run

🗳️ Vote Values Reference

Vote Meaning
10 Approved
5 Approved with suggestions
0 Reset vote
-5 Waiting for author
-10 Rejected

📝 Notes

  • compact: Set to false to get the full raw Azure DevOps API response. Default is true (simplified output optimized for LLM consumption).
  • org / project: Auto-detected from the current git remote. Pass explicitly to override.
  • voterId: Your Azure DevOps identity GUID (required for voting). Find it in your ADO profile URL: https://dev.azure.com/{org}/_usersSettings/identities.
  • Reviewer IDs in azdo_pr_create: Must be Azure DevOps identity GUIDs, not email addresses.
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.3.2 104 9/29/2026
1.3.1 125 9/9/2026
1.3.0 115 9/8/2026
1.2.1 135 8/5/2026
1.2.0 120 8/5/2026
1.1.2 128 8/5/2026
1.1.1 128 7/27/2026
1.1.0 123 7/27/2026
1.0.6 131 7/22/2026
1.0.5 120 7/22/2026
1.0.4 121 7/21/2026
1.0.3 114 7/21/2026
1.0.2 136 6/24/2026
1.0.1 137 6/22/2026
1.0.0 131 6/22/2026