--- title: "ado-pr" url: "https://claudemods.dev/ko/builds/ado-pr-05d512" source: "https://github.com/Pro-Sharp/ado-pr-claude-plugin/tree/main/plugins/ado-pr" source_type: "github" repo: "https://github.com/Pro-Sharp/ado-pr-claude-plugin/tree/main/plugins/ado-pr" author: "Pro-Sharp" author_handle: "Pro-Sharp" stars: 0 category: "Git 및 코드 리뷰" categories: ["git"] tags: ["auto-merge", "azure-devops", "ci-status", "code-review", "hooks", "pull-requests"] permission_level: 2 scan_complete: true install: "claude plugin marketplace add Pro-Sharp/ado-pr-claude-plugin\nclaude plugin install ado-pr@azure-devops-pr" added: "2026-10-10T00:39:49.485Z" updated: "2026-10-10T00:39:49.485Z" locale: "ko" content_locale: "ko" --- # ado-pr 프롬프트 위에 Azure DevOps 끌어오기 요청 표시줄을 추가하는 Claude Code mod로, 각 채팅의 PR, +/- 줄 수, 빌드 유효성 검사(CI) 상태, 검토자, 미해결 댓글을 표시하고 Azure CLI를 통해 PR 만들기, CI 자동 수정, 댓글 처리, 자동 완성 작업을 수행합니다. ## Description Azure DevOps 끌어오기 요청 표시줄(플러그인 ID ado-pr)은 Claude Code Desktop이 프롬프트 위에 표시하는 GitHub 스타일 PR 표시줄을 Azure Repos용으로 재현합니다. 표시줄, 호버 요약 카드, 빌드 유효성 검사, 정책, 검토자가 포함된 CI 팝오버를 그리고, Create PR 버튼과 CI 자동 수정 및 댓글 처리, 준비되면 자동 병합 스위치를 추가합니다. 각 채팅은 자체 PR 표시줄을 유지하며, 오래된 PR이나 외부에서 만든 PR에는 /ado-pr find 및 /ado-pr link를, 자신의 PR을 나열하려면 /ado-pr mine을 사용합니다. 또한 Claude를 위해 네 가지 도구(create_pull_request, pull_request_status, build_failure_logs, reply_to_pr_comment)를 등록합니다. 모든 것은 컴퓨터에 이미 설치되어 로그인된 az 및 git을 통해 로컬로 실행됩니다 — 서버도 토큰 처리도 없습니다 — 상태는 폴링(기본값 60초)과 프롬프트, 턴, git push 후 다시 읽기를 통해 갱신됩니다. 요구 사항은 Claude Code 2.1.287+, Azure CLI azure-devops 확장, 인증된 az 세션, 그리고 origin이 Azure Repos인 복제본입니다. ## Install ``` claude plugin marketplace add Pro-Sharp/ado-pr-claude-plugin claude plugin install ado-pr@azure-devops-pr ``` ## Original README
# Azure DevOps Pull Requests Bar - Claude mod **Azure DevOps pull requests in Claude Code: the same PR bar the desktop app shows for GitHub, built on the Azure CLI.** [![Claude Code mod](https://img.shields.io/badge/Claude%20Code-mod-d97757)](https://code.claude.com/docs) [![Azure CLI](https://img.shields.io/badge/Azure%20CLI-azure--devops-0078d4)](https://learn.microsoft.com/en-us/azure/devops/cli/) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) The PR bar above the prompt, with the hover card for the PR open above it
When you work on a GitHub repository, Claude Code Desktop shows a bar above the prompt with the branch's pull request: its number, its `+/−` lines, a CI indicator with a dropdown, and switches for **Auto-fix CI** and **Auto-merge**. Azure Repos gets none of that. **Azure DevOps Pull Requests Bar** (plugin id `ado-pr`) is a [Claude Code mod](https://claude.dev/blog/getting-started-with-claude-code-mods/) that draws the same bar for **Azure DevOps**, using only `az` and `git` on your machine. > **Bar missing in a chat?** Each chat shows the PRs it created. For a chat that made its PR before you installed the plugin, or one Claude opened some other way: > > - `/ado-pr find` (or the **Find PR** button) looks through the chat's history and adds every PR of this repository it mentions. > - `/ado-pr link ` adds any PR by its number, for example `/ado-pr link 1234`. > > All commands are listed under [Commands](#commands). ## Quick start ```bash claude plugin marketplace add Pro-Sharp/ado-pr-claude-plugin ``` ```bash claude plugin install ado-pr@azure-devops-pr ``` This installs and enables the CLI version. You need to manually enable it on Claude Desktop in the Customize menu to enable it on UI too. One PR bar above the prompt You also need the Azure CLI with the `azure-devops` extension, signed in with `az login`, and a clone whose `origin` is Azure Repos (see [Requirements](#requirements)). Other ways to install are under [Install](#install). ## See it in action **A bar for the chat's pull request**, right above the prompt: state icon, `#id`, repository, source branch, `+/−` lines and the CI panel. One PR bar above the prompt The whole feature set works in **CLI as well.** CI panel open above the PR bar in Claude Code CLI **Hover `#id`** for the summary card, as in the screenshot at the top: state, title, author, `+/−` and the number of files. Hover panel on #id **Click CI ▾** for the CI panel: build validations, policies and reviewers, and the **Auto-fix CI & address comments** and **Auto-merge when ready** switches. CI panel open above the PR bar CI panel open above the PR bar in Claude Code CLI **When the PR merges** you get a notice, the icon turns purple, and **Create PR** comes back for the next one. Merged PR with a notice and the Create PR row **Older chats** offer **Find PR**, which looks through the chat's history for the pull requests it created. Find PR and Create PR on a chat without a PR Find PR looking through the chat **Every PR the chat has made** gets its own bar, each on its own branch. Orange is abandoned, purple is merged, green is open. Four PR bars found in one chat ## Features | | GitHub (built into Desktop) | **This plugin** (Azure DevOps) | | --------------------------------------------- | --------------------------- | ---------------------------------------------------------------------------------- | | PR bar above the prompt: number, repo, branch | ✅ | ✅ green open · grey draft · purple merged · orange abandoned | | `+added −removed` lines | ✅ | ✅ from `git diff --shortstat` of the PR's merge commits | | CI dot and dropdown with check counts | ✅ | ✅ build validation and status policies, each linked to its run | | **Create PR** button | ✅ | ✅ Claude pushes, writes the title and description, opens the PR | | Auto-fix CI | ✅ | ✅ failed build logs (errors and log tail) handed to Claude | | Address review comments | ✅ | ✅ unresolved threads handed to Claude, who replies and resolves them | | Auto-merge when ready | ✅ | ✅ Azure DevOps **auto-complete** (squash or merge commit, optional branch delete) | | PR state in the sidebar for every chat | ✅ | ❌ not possible for a mod; `/ado-pr mine` lists your PRs in a pane instead | | Live updates | webhooks | polling (60 s by default), plus a refresh after every prompt, turn and `git push` | | Hover card on `#id` | ✅ | ✅ state badge, title, author, `+/−`, file count | | Several PRs per chat | ✅ | ✅ one bar each, kept with the chat; **Find PR** adds the ones from older chats | Claude also gets four tools it can call: `create_pull_request`, `pull_request_status`, `build_failure_logs` and `reply_to_pr_comment`. ## Requirements - **Claude Code 2.1.287 or later** (mods are on by default from that version), in the terminal or the desktop app's Code tab - **Azure CLI** with the **azure-devops** extension ```bash az extension add --name azure-devops ``` - Signed in, either with your Microsoft Entra account or a PAT ```bash az login ``` ```bash az devops login --organization https://dev.azure.com/ ``` - A git clone whose `origin` is Azure Repos. Every URL form works: `https://dev.azure.com/…`, `https://.visualstudio.com/…`, and SSH `git@ssh.dev.azure.com:v3/…` The organization, project and repository come from `origin`, so you don't need `az devops configure --defaults`. ## Install At the prompt of a Claude Code **terminal** session: ```text /plugin install ado-pr --marketplace Pro-Sharp/ado-pr-claude-plugin ``` Answer `y` to add the marketplace and pick the **user** scope. The mod is active immediately and loads in every later session, including the desktop app's Code tab.
Other ways to install Add the marketplace first, then install from it: ```text /plugin marketplace add Pro-Sharp/ado-pr-claude-plugin /plugin install ado-pr@azure-devops-pr /reload-plugins ``` Run it from a local clone for a single session: ```bash claude --plugin-dir ./plugins/ado-pr ``` Load a local clone in every session, desktop included. Add this to `~/.claude/settings.json`: ```json { "env": { "CLAUDE_CODE_PLUGIN_DIRS": "C:/path/to/ado-pr-claude-plugin/plugins/ado-pr" } } ```
## Updating An installed copy doesn't follow the repository by itself. To get the latest release: ```bash claude plugin marketplace update azure-devops-pr ``` ```bash claude plugin update ado-pr ``` Then run `/reload-plugins` in an open session, or start a new one. [CHANGELOG.md](CHANGELOG.md) lists what changed in each version. Running from a local clone (`--plugin-dir`, `CLAUDE_CODE_PLUGIN_DIRS`, or a marketplace added from a folder)? Pull the changes and run `/reload-plugins`; there's nothing to update. ## Usage Open a session in an Azure Repos clone. - **Each chat has its own PRs.** A chat shows a bar for every PR it created, found or linked, open or closed, whatever branch the folder is on now. Two chats of the same repository never show each other's PRs. A chat can hold several PRs (one abandoned, a newer one open, each on its own branch), one bar each. - **A chat without an open PR** shows the current branch with **Find PR** and **Create PR**. - **Find PR** looks through the chat's own history for PR links and ids, keeps the ones from this repository, and adds a bar for each. Use it in chats from before 0.3.0. - **Create PR**: Claude commits and pushes the branch, writes a title and description from the diff, and opens the PR through its `create_pull_request` tool. Asking Claude for a PR in plain words does the same. A PR Claude opens with `az repos pr create` is added too. - **Each bar**: hover `#id` for a summary card (state, title, author, `+/−`, files), and click it to open the PR in Azure DevOps. Click **CI ▾** to open that PR's CI panel. **Remove from chat** in the panel takes the bar away. Cards and panels open inside the bar area, which grows upward from the prompt: a mod can't draw over the chat. - **×** hides the bar for the session. `/ado-pr show` brings it back. ### The CI popover | Control | What it does | | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Auto-fix CI & address comments** | Each build validation that fails is handed to Claude **once**, with the failed steps, their `##[error]` lines and the log tail. Unresolved review threads are handed over too. Claude fixes the code, pushes, and replies on each thread. Turning it on also acts on what is already failing or open. | | **Auto-merge when ready** | Turns Azure DevOps **auto-complete** on or off (`az repos pr update --auto-complete`). The PR then completes by itself once every required policy passes. | | **Fix CI now** / **Address comments** | Run the same hand-over once, on demand. | | **Publish draft** | Takes a draft PR out of draft. | ### Commands | Command | | | ----------------------------- | ---------------------------------------------------------------------------------------- | | `/ado-pr` or `/ado-pr status` | Re-read and summarize the PR | | `/ado-pr refresh` | Re-read now | | `/ado-pr create` | Same as the **Create PR** button | | `/ado-pr find` | Same as **Find PR**: add the PRs this chat's history mentions | | `/ado-pr link ` | Add any PR to this chat | | `/ado-pr unlink [id]` | Remove one PR from this chat, or all of them | | `/ado-pr fix` | Hand the failed builds to Claude now | | `/ado-pr comments` | Hand the unresolved comments to Claude now | | `/ado-pr mine` | Open a pane with your PRs in this project | | `/ado-pr show` | Show the bar again after **×** | ## Configuration `/config` shows these options under **Azure DevOps Pull Requests Bar** (`ado-pr`). You can also set them in `settings.json` under `pluginConfigs["ado-pr"].options`. | Option | Default | | | -------------------- | --------- | ------------------------------------------------------------------------------------------------------- | | `pollSeconds` | `60` | How often the PR, its builds and its comments are re-read. `0` turns polling off. | | `mergeStrategy` | `squash` | `squash` or `noFastForward` (a merge commit), used by **Auto-merge when ready**. | | `deleteSourceBranch` | `false` | Delete the source branch when auto-complete merges. | | `azPython` | _(empty)_ | Windows only: path to the Azure CLI's bundled `python.exe`, when it isn't in the standard MSI location. | ## How it works ```mermaid flowchart LR subgraph Claude Code band["AbovePrompt band
+ CI menu"] pane["/ado-pr mine pane"] tools["Claude's tools
create · status · logs · reply"] end mod["ado-pr hooks module
($.state, $.clock.every)"] git["git
(origin, branch, shortstat)"] az["az repos / az pipelines /
az devops invoke"] ado[("Azure DevOps
REST API")] band <--> mod pane <--> mod tools <--> mod mod -- $.process.run --> git mod -- $.process.run --> az az --> ado ``` The mod has no server and handles no tokens. Every call is an `az` or `git` command run as you, and `az` uses the sign-in it already has. [docs/az-cli-mapping.md](docs/az-cli-mapping.md) lists the command behind each feature. [docs/architecture.md](docs/architecture.md) describes the module layout and the event flow. ## Limitations - **Sidebar badges.** Desktop draws the PR state in the sidebar for GitHub sessions, but the sidebar is part of the desktop app itself, not something a mod can draw. `/ado-pr mine` is the substitute. - **Events are polled.** GitHub sessions get webhook-driven events. Azure DevOps service hooks can't reach a local session, so the mod re-reads every `pollSeconds` and right after any `git push`, `git checkout`/`switch` or `az repos pr` command Claude runs. - **`+/−` needs the commits locally.** When the PR's commits aren't in your clone, the mod fetches them once. If the fetch fails, the counts are left out. - **No Create PR on the default branch.** Create a feature branch first. - **Auto-fix trusts what reviewers write.** Comment text and build logs are handed to Claude as instructions to act on. Leave the switch off on repositories where untrusted people can comment. [SECURITY.md](SECURITY.md) has more. ## Troubleshooting | You see | Fix | | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `Not signed in to Azure DevOps` | `az login`, or `az devops login` with a PAT that has _Code (read & write)_ and _Build (read)_ scopes | | `The azure-devops extension is missing` | `az extension add --name azure-devops` | | `Could not start the Azure CLI` | Install it from https://aka.ms/azcli. On Windows with a non-MSI install, set the `azPython` option. | | Garbled accented names on Windows | Make sure the mod found the bundled `python.exe` (it adds `-X utf8`). Set `azPython` if your install is elsewhere. | | No bar at all | Check that `origin` is an Azure Repos URL (`git remote get-url origin`) and run `/ado-pr status`. Start `claude --debug` to see the mod's log lines. | ## Development ```bash claude plugin validate plugins/ado-pr ``` ```bash claude plugin test plugins/ado-pr ``` ```bash claude --plugin-dir ./plugins/ado-pr ``` Saving a file reloads the mod in a running session. Claude Code writes its own type declarations to `plugins/ado-pr/.claude-plugin/types/` each time it loads the mod, and after that `tsc -p plugins/ado-pr` type-checks the mod. [CONTRIBUTING.md](CONTRIBUTING.md) has the details. [docs/research.md](docs/research.md) records what we found about Claude Code's own GitHub integration and how to track upstream changes. ## Contributing Issues and pull requests are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) and the [Code of Conduct](CODE_OF_CONDUCT.md) first. ## License [MIT](LICENSE) © Adam Kovacs ## Star History [![Star History Chart](https://app.repohistory.com/api/svg?repo=Pro-Sharp/ado-pr-claude-plugin&type=Timeline&background=0D1117&color=b562f8)](https://app.repohistory.com/star-history) --- Not affiliated with or endorsed by Anthropic or Microsoft. "Claude" is a trademark of Anthropic. "Azure DevOps" is a trademark of Microsoft. Mods run with Claude Code's access to your machine, so read the source before you install any of them, this one included.