🚀 ADOExt — Azure DevOps for VS Code

A full-featured Azure DevOps integration for Visual Studio Code, bringing the power of ADO directly into your editor. Manage work items, pull requests, builds, and team collaboration—all without leaving VS Code.

UI Preview

PR details and review workflow directly in VS Code.

Changelog

See CHANGELOG.md for the full release history.

---

✨ Key Features

📋 Work Item Management

• Detailed work item editing, discussion, and linked build context in one panel.

• Browse & Filter — View work items assigned to you, created by you, or across your entire portfolio

• Multi-Org Aggregation — Work items aggregate seamlessly across selected organizations and projects, grouped by project and state

• Regex Filtering & Sorting — Filter work items by regex pattern (ID, title) and sort by name or creation date; buttons in the Work Items view header

• Rich Details Panel — One-click to open full work item details in a dedicated webview panel

  • Edit title, description, state, priority, assignee, area path, iteration, and tags
  • View and participate in discussion comments
  • See work item history and linked items
  • Open in browser anytime for advanced ADO features

• ADO-Style Icons — Custom icons for bugs, tasks, epics, features, stories, PBIs, and issues

• State Changes — Change work item state directly from the sidebar

🎯 Create Work Items from Your Code

• Turn TODOs and code selections into tracked work with captured editor context.

• From Selection — Highlight text in the editor and run ADOExt: Create Work Item from Selection to create a new work item with your selected text as the title

• From TODO Comments — VS Code code action (💡) appears on TODO comments; click to create a work item directly from the comment

• File Context — Work items automatically include the source file path and context lines for quick reference

🔍 Smart Code Completions

• Autocomplete work item references and teammate mentions while typing in code, markdown, and commits.

• Work Item References — Type # or AB# in markdown, plaintext, or git commits to see IntelliSense completions for recent work items

  • Shows work item ID, title, type, and state
  • Filter by typing ID digits or title keywords
  • Works with both #123 and AB#123 reference formats

• Team Mentions — Type @ to autocomplete team member names from your project

  • Quickly mention colleagues in descriptions, comments, and commit messages
  • Filters by display name and email prefix

🎨 Hover Cards for ADO References

• Get instant work item and PR context from inline references, with direct action links.

• Work Item Hovers — Hover over AB#123 or #123 references in any open file to see a rich detail card

  • Shows title, type, state, assignee, and project scope
  • Quick actions: Open in Browser, View Details panel

• Pull Request Hovers — Hover over PR #123, PR!123, or !123 to see PR details

  • Shows title, status, repository, and author
  • Quick link to open in browser

• Smart Scope Resolution — Hovers work across multi-project setups; when ambiguous, shows the matched scope

✅ Pull Request Management

• Review threads, checks, test results, and merge actions in one focused PR workspace.

• Browse PRs — View active pull requests (yours, created, assigned to you, all) aggregated across organizations/projects

• Regex Filtering & Sorting — Filter PRs by regex pattern (ID, title) and sort by title or creation date; buttons in the Pull Requests view header

• Inline Review — Expand PRs in the tree to see all comment threads; reply, resolve, or reopen directly from the sidebar

• Rich PR Details Panel — One-click to see full PR information, discussions, and reviewer status

• Familiar Review UX — The pull request review flow is inspired by the GitHub Pull Requests and Issues extension for VS Code, adapted for Azure DevOps workflows

• Native Diff Editor — Review changes in VS Code's native multi-diff editor (same UX as GitHub PR extension)

  • All changed files visible at once
  • Inline PR comments in the gutter
  • Add new line comments with the + affordance

• Checked-Out Branch — After running "Checkout Pull Request Branch", existing PR threads light up in your regular editor

• Smart Notifications — Toast notifications for new PR comments; configure poll frequency and notification types

• PR Queries & Buckets — Organize PRs by review state (Waiting for My Review, Created by Me, All Open) or save custom queries

📦 Backlog, Sprints & Boards

• Planning views with fast filtering, state updates, and assignee-aware workflow.

• Hierarchical Backlog — View parent/child work item relationships in a collapsible tree

• Sprint Planning — Browse work grouped by sprint/iteration with drag-and-drop reordering

• Regex Filtering & Sorting — Filter and sort items in Backlog and Sprint views by regex pattern or name/date (controls in the editor view toolbar)

• Assigned-to-Me Planning Filter — Toggle Backlog/Sprint/Board trees between all items and items assigned to you

• Board View — See work organized by state columns (To Do, In Progress, Done, etc.)

• Editor Views — Open Backlog and Board editor views for wider planning layouts

• State Changes — Update work item state from planning views; sidebar automatically refreshes

• Linked Details — Open any work item from planning views in the shared details panel

🔐 Multi-Account & Multi-Organization

• Select multiple accounts, organizations, and project scopes for aggregated cross-team workflows.

• Built-in Auth — Uses VS Code's Microsoft authentication (no manual token management)

• Multiple Accounts — Sign in with multiple Microsoft accounts and switch seamlessly

• Organization Picker — Select one or multiple organizations or all orgs in your account

• Project Picker — Choose projects per organization or select all projects

• Smart Aggregation — All views (work items, PRs) automatically aggregate across your selection

🏗️ Build & Integration

• Pipeline run diagnostics, timeline details, and quick actions without leaving the editor.

• Build Summaries — Lightweight build status cards in PR and work item detail panels

• Pipelines View — Browse recent Azure Pipelines runs across selected scopes; filter/group runs, inspect timeline details, open step logs from the tree or details timeline in VS Code, and open artifacts

• MCP Server — Official Azure DevOps MCP integration with shared configuration and auth options

• Azure Boards Integration — Full WIQL query support for advanced filtering and bulk operations

---

📥 Installation

From VS Code Marketplace:

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "ADOExt"
4. Click Install

From Source:

git clone https://github.com/CompN3rd/ADOExt
cd ADOExt
npm install
npm run compile
code --install-extension ./adoext-<version>.vsix

---

🚀 Quick Start

1. Sign In

• Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
• Run ADOExt: Sign In
• Authenticate with your Microsoft account

2. Select Organization

• Run ADOExt: Select Organization
• Choose your Azure DevOps organization(s)

3. Select Projects

• Run ADOExt: Select Project
• Choose project(s) to work with

4. Explore the Sidebar

• Work Items — Browse assigned, created, and all work items
• Pull Requests — View PRs organized by bucket (Waiting for Review, Created by Me, All Open)
• Backlog — Hierarchical view of all work
• Sprints — Current and future sprint planning
• Boards — Kanban-style board view
• Pipelines — Recent CI/CD runs across your selected scopes

---

⚙️ Configuration

Open VS Code Settings (Ctrl+, / Cmd+,) and search for adoext to customize:

Setting	Description	Default
adoext.notifyOnNewPullRequestComments	Show toast when PRs get new comments	true
adoext.pullRequestCommentPollIntervalSeconds	How often to check for new PR comments	60
adoext.workItemQueries	Custom saved work item query filters	(defaults)
adoext.pullRequestQueries	Custom saved PR query filters	(defaults)
adoext.projectsByOrganization	Multi-org project selection	{}

---

🔌 MCP Server Integration

ADOExt integrates with the official Microsoft Azure DevOps MCP server (@azure-devops/mcp).

Use ADOExt: Copy MCP Server Configuration to generate a ready-to-paste .vscode/mcp.json entry for interactive auth, bearer token (ADO_MCP_AUTH_TOKEN), or PAT (PERSONAL_ACCESS_TOKEN) setups.

---

🎯 Commands

Command	Shortcut	Purpose
ADOExt: Sign In	—	Authenticate with Microsoft
ADOExt: Select Organization	—	Choose organization(s)
ADOExt: Select Project	—	Choose project(s)
ADOExt: Create Work Item	—	Create a new work item interactively
ADOExt: Create Work Item from Selection	—	Create work item from highlighted text
ADOExt: Create Work Item from TODO	—	Scan active file for TODO comments
ADOExt: Open Saved Query	—	Browse and open saved work item queries
ADOExt: Refresh Work Items	—	Manually refresh work items tree
ADOExt: Refresh Pull Requests	—	Manually refresh PR tree
ADOExt: Checkout Pull Request Branch	—	Check out a PR branch locally

---

📋 Requirements

• VS Code 1.101.0 or later
• Git (for PR branch checkout)
• Azure DevOps Account with at least read access to your organization
• Microsoft Authentication in VS Code (built-in; uses existing sign-in)

---

🤝 Contributing

We welcome contributions! Please feel free to open issues or pull requests on GitHub.

Development Setup

git clone https://github.com/CompN3rd/ADOExt
cd ADOExt
npm install
npm run compile      # Build extension TypeScript and webview bundles
npm run watch        # Watch extension TypeScript
npm run watch:webviews # Watch bundled webview assets
code .               # Open in VS Code for testing

---

📝 License

This extension is open source and available under the MIT License.

---

🐛 Feedback & Support

Found a bug or have a feature request? Open an issue on GitHub.

Happy coding! 🎉