azdo.nvim

Note

Work with Azure DevOps pull requests in Neovim. WIP/beta — PRs/feedback welcome!

azdo.nvim is a port of guh.nvim (by justinmk) from GitHub to Azure DevOps. It keeps guh's minimalist workflow and its UI machinery — diff comments in a 'scrollbind' split, vim.diagnostic, and the quickfix list — but swaps the backend: instead of the GitHub gh CLI it shells out to the Azure CLI (az rest for the Azure DevOps REST API) plus local git for diffs.

The only provider-specific module is lua/azdo/az.lua; everything else (comments.lua, state.lua, util.lua) is shared, agnostic UI code.

Usage

Run :Azdo to see status (open PRs for the current repo):

:Azdo

Run :Azdo 42 to view PR/work-item 42 (it probes: a PR id opens the PR; otherwise a work item). Also accepts an Azure DevOps URL, an org/project/repo#42 slug, or a commit SHA:

:Azdo 42
:Azdo a1b2c3d
:Azdo https://dev.azure.com/myorg/MyProject/_git/myrepo/pullrequest/42
:Azdo myorg/MyProject/myrepo#42
:Azdo azdo://myorg/MyProject/myrepo/pr/42
:Azdo https://dev.azure.com/myorg/MyProject/_workitems/edit/1234

Inside any azdo:// buffer, press <Enter> to run :Azdo on the target at cursor. Hit g? to review the keymaps.

Run :Azdo items for the work-items dashboard (items assigned to you by default). In it: t tags/pins an item, s sorts and groups the list (by changed/created date, state in board order, type, or assignee — grouped under subheadings), ga filters by assignee (a multi-select popup — pick All, just yourself, or a few teammates), and cc sets a work item's State via a picker — the keyboard equivalent of dragging a card between columns on the Azure board. Groups are foldable (items.fold = true to start all collapsed, or items.fold = { "Done" } to start just those state groups folded; za/zR/zM to expand), and items.hide_states = { "Done" } tucks finished work away entirely — gh toggles it back into view. Set the default audience with items.assignee ("me" / "all" / a name / a list of names), and list the teammates you filter by in items.assignees so the ga picker shows them instantly (no extra query).

Don't want to memorize commands? Run :AzdoMenu for a context-aware command palette (it routes through vim.ui.select, so your Telescope/fzf-lua/snacks picker renders it). Bind it for quick access, e.g. vim.keymap.set('n', '<leader>a', '<Plug>(azdo-menu)').

When viewing a PR:

• Diff comments are presented (1) in a 'scrollbind' split, (2) as "diagnostics" (vim.diagnostic), (3) loaded in quickfix.
• cc (or visual c) comments on a diff line/range; cr replies-to or resolves a thread.
• cR reviews the PR (approve / request-changes / comment → reviewer vote).
• cM completes (merges) the PR (squash / merge / rebase, optional --admin bypass).
• c: edits the PR title/description (or opens a work item in the browser).
• dl shows the most-recent pipeline logs for the build on the PR.

Editable buffers (comments, merge/complete message, PR edit) confirm on write-and-close (ZZ submits, ZQ discards).

Default keymaps are configurable via setup({ keymaps = { merge = 'cm', … } }), or set one to false to drop it (keymaps = false disables all). They're also exposed as <Plug>(azdo-…) maps — define your own mapping to one and azdo skips its default. See the help file.

Install

With lazy.nvim:

{ 'https://github.com/<you>/azdo.nvim', opts = {} }

With vim.pack (or any manual loader), call setup() yourself:

vim.pack.add{ 'https://github.com/<you>/azdo.nvim' }
require('azdo').setup{}

Configure

setup() takes a single options table (all optional; defaults target cloud Azure DevOps):

require('azdo').setup({
  base_url       = nil,    -- on-prem collection root; nil = cloud dev.azure.com
  pat            = nil,    -- PAT string, or a function returning one; else az login
  project        = "org/project",  -- default project for `:Azdo items`
  pr             = { comments = { width = 30 } },  -- PR diff/comments split: comments pane = 30% of editor width
  items          = { split = "vertical", size = 40, sort = "changed", group = true, fold = false, assignee = "me", assignees = { "Jane Doe" }, hide_states = {} },  -- open_split + dashboard sort/group/fold/assignee(s)/hide
  menu           = "<leader>a",    -- key for the :AzdoMenu command palette
  -- workitem_sections, keymaps, api_version, create_in_tab, debug … see :help azdo-config
})

You can also map the Lua API directly: require('azdo').status(), .work_items(), .create_pr(), .menu(), .merge(), .review(), etc.

Requirements:

• Nvim 0.13+
• Azure CLI (az) — authenticated via az login.
• The azure-devops extension (az extension add --name azure-devops) — used for work-item views.
• A local clone of the repo (the PR diff is produced with local git; see below).
• (Optional) For highlighting diffs, a plugin such as diffs.nvim.

How it differs from guh.nvim / GitHub

Azure DevOps' data model isn't identical to GitHub's, so a few behaviors are mapped:

guh / GitHub	azdo / Azure DevOps
Issues	Work items (az boards work-item, project-level)
PR review comments	PR threads (/pullRequests/{id}/threads)
Approve / request-changes	Reviewer vote (+10 / -10)
Merge	Complete PR (squash / noFastForward / rebase strategy)
Checks / Actions logs	Pipelines builds + timeline logs
per-file "Viewed" state	Not exposed by the API → nothing is collapsed

Notable limitations:

• The PR diff requires a local clone whose origin is the PR's repo. azdo fetches refs/pull/<id>/merge and runs git diff locally — Azure DevOps has no unified-diff REST endpoint like gh pr diff. Comments still load over REST even if the diff can't be produced.
• Auth comes from az login (every REST call passes --resource <Azure DevOps GUID>). No PAT is required.

Manual smoke test

The automated tests cover only the pure parsing logic (make test). To exercise the REST/diff paths, from a local Azure DevOps clone:

:Azdo                  " list open PRs
:Azdo <pr-id>          " open a PR: overview + diff + comments
" on a diff line: cc to comment, cr to reply/resolve, cR to vote, cM to complete

Credits

Forked from guh.nvim by justinmk, which was itself rewritten from ghlite.nvim by Dalius Dobravolskas.