Repository files navigation

Integrate Azure DevOps work items, time tracking, branching, and pull requests directly inside VS Code.

• Work Items Management: Unified view with built-in filters (My Activity, Assigned to Me, Current Sprint, All Active, Recently Updated) and custom WIQL support
• Time Tracking: Lightweight timer with inactivity auto-pause, status bar integration, and automatic work item updates
• Git Integration: Create branches and pull requests directly from work items with customizable naming templates
• Smart Setup: Easy setup wizard that parses work item URLs and guides you through configuration
• Enhanced On-Premises Support: Robust support for Azure DevOps Services (cloud) and Azure DevOps Server (on-premises)
  • Smart URL parsing handles 3-segment paths (collection/organization/project)
  • Connection-specific PAT storage with username prompts for on-premises
  • Intelligent loading states ("Initializing..." → "Loading..." → content)
  • Fixed query execution for "Assigned to me" and "My Activity" on TFS/Server
• AI-Powered Summaries: Generate work summaries using Copilot prompts or OpenAI integration
• Multiple Views: Switch between list and Kanban views with preserved scroll positions and keyboard navigation
• Secure Storage: PAT tokens stored securely per-connection in VS Code's secret store with automatic migration

For details on how this extension handles authentication, data access, and runtime security, please read our fullSecurity & Trust Notice.

• 🎯 Bulk Operations: Multi-select work items and apply changes in batch

  • Select with Ctrl/Cmd+Click or checkboxes
  • Bulk assign, move states, add tags, or delete
  • Real-time progress tracking with error handling
  • Animated toolbar appears when items selected

• 🔍 Filter & Query Management: Complete filtering system

  • Interactive Query Builder with 5 pre-built templates
  • Save and manage named filter sets
  • Export/import filter configurations as JSON
  • WIQL syntax help and validation

• 📊 Performance Monitoring: Real-time observability

  • Performance Dashboard with operation metrics
  • Memory usage tracking and optimization tips
  • Cache statistics and hit rates
  • Manual garbage collection

• 🚀 Performance Optimization: Intelligent caching system with 60-80% faster API responses

• ⌨️ Keyboard Navigation: Vim-style shortcuts (r, v, /), multi-select with Space/Esc/Ctrl+A

• ♿ Accessibility: Full ARIA support, screen reader compatibility, keyboard-only operation

• 🔧 Enhanced Error Handling: Detailed, actionable error messages with troubleshooting steps

From VS Code: Extensions view → search "Azure DevOps Integration" → Install.

Command palette quick install:

1. Press Ctrl+P (Cmd+P on macOS)
2. Type: ext install PluresLLC.azure-devops-integration-extension
3. Press Enter

Marketplace page:Azure DevOps Integration – VS Code Marketplace

Sign in with your Microsoft account—no token creation needed:

• OAuth 2.0 Authentication: Modern, secure authentication flow
• Automatic Token Refresh: Tokens refresh automatically in the background
• Status Bar Expiration Indicator: See how long each token has left and click to reconnect; the button automatically cycles through every connection that needs attention
• Webview Reminders: Work Items view surfaces sign-in reminders with one-click reconnect or a 30-minute snooze
• Device Code Flow: Simple browser-based sign-in, with the device code automatically copied to your clipboard when you chooseOpen Browser
• No Manual Setup: No need to create or manage Personal Access Tokens

If you prefer or need PAT authentication:

Required scopes (minimum recommended):

• Work Items (Read & Write)
• User Profile (Read)
• Team (Read)
• Code (Read & Write) – optional, for PRs & repos
• Build (Read) – optional, for planned build status features

Generate at: Azure DevOps → User Settings → Security → Personal Access Tokens.

1. Open the Command Palette (Ctrl+Shift+P /Cmd+Shift+P)
2. Run:Azure DevOps Integration: Setup Wizard (Easy)
3. Paste a work item URL from your Azure DevOps organization
4. The wizard will auto-detect your organization and project
5. Choose Authentication Method: Microsoft Entra ID (recommended) or Personal Access Token
6. For Entra ID: Follow the device code flow to sign in; selectingOpen Browser copies the device code to your clipboard and opens the Microsoft sign-in page
7. For PAT: Follow the guided steps to create a Personal Access Token
8. Test your connection and you're ready to go!

Tip: If a Microsoft Entra connection loses access, the Work Items view shows a reminder banner and the status bar button cycles through each affected connection so you can reconnect quickly.

1. Run:Azure DevOps Integration: Setup Connection
2. Provide your Organization (short name), Project, and PAT
3. The extension stores the PAT securely in VS Code's secret store

• UseAzure DevOps Integration: Select Team to set a team context
• When set, the "Current Sprint" query uses that team's current iteration
• You can change or clear this anytime by running the command again

The extension fully supports on-premises Azure DevOps Server installations:

1. During Setup: Use a work item URL from your on-premises server (e.g.,https://myserver/DefaultCollection/MyProject/_workitems/edit/123)
2. Manual Configuration: SetazureDevOpsIntegration.baseUrl to your server's base URL (e.g.,https://myserver/DefaultCollection)
3. The extension automatically detects and uses your on-premises server for all API calls

Authentication Note: Azure DevOps Server (on-premises) only supportsPersonal Access Token (PAT) authentication. Microsoft Entra ID (OAuth) is only available for Azure DevOps Services (cloud). The setup wizard automatically selects the appropriate authentication method based on your server type.

Tip: Ensure your PAT has appropriate permissions for your on-premises server. Seedocs/ONPREMISES_TESTING.md for detailed testing scenarios.

• Look for the "Azure DevOps" icon in the Activity Bar
• Click to open the "Work Items" view
• Browse, filter, and manage your work items with list or Kanban views

• Start/Stop Timer: Click the timer button on any work item or use the command palette
• Smart Pause: Automatically pauses after inactivity (configurable timeout)
• Auto-Resume: Resumes when you become active again
• Time Reports: View tracked time across different periods (Today, Week, Month, All Time)
• Automatic Updates: When stopping a timer, automatically updates work item's Completed/Remaining hours
• AI Summaries: Generate work summaries using Copilot prompts or OpenAI integration

• Copilot Integration: Generate Copilot-ready prompts for work summaries
• OpenAI Support: Direct integration with OpenAI for automatic summary generation
• Smart Drafts: Per-work-item draft persistence for refining your messages
• Timer Integration: Auto-selects active work item when generating summaries

• Multi-Select UI: Click checkboxes or Ctrl/Cmd+Click to select multiple work items
• Bulk Assign: Assign multiple work items to any user at once
• Bulk Move: Change state for multiple items simultaneously
• Bulk Add Tags: Add tags to multiple items with smart merge (no duplicates)
• Bulk Delete: Soft delete with double-confirmation for safety
• Visual Feedback: Animated toolbar, progress tracking, and selection count

• Query Builder: Interactive WIQL construction with 5 pre-built templates
  • My Work Items, Recently Changed, Active Bugs, Current Sprint, Unassigned Items
  • Live syntax validation with helpful error messages
  • Comprehensive WIQL help reference
• Saved Filters: Save, load, delete, and manage named filter sets
• Export/Import: Share filter configurations as JSON files
• Quick Actions: Clear all filters (/), focus search, manage saved queries

• Performance Dashboard: Comprehensive metrics and health analytics
  • Operation statistics (duration, error rate, cache hit rate)
  • Memory usage tracking (current, peak, RSS)
  • Cache statistics and optimization recommendations
• Clear Performance Data: Reset baseline metrics
• Force Garbage Collection: Manual memory cleanup (if --expose-gc enabled)
• Intelligent Caching: 60-80% faster API responses with automatic memory management
• Smart Optimization: Automatic garbage collection and performance recommendations

• Navigation:r to refresh,v to toggle Kanban view
• Search:/ to focus search box
• Selection:Space to toggle selection,Esc to clear,Ctrl+A to select all
• Multi-Select:Ctrl/Cmd+Click on work items to build selection
• Accessibility: Full keyboard-only operation with screen reader support

The most important settings you might want to configure:

{// Time tracking"azureDevOpsIntegration.defaultElapsedLimitHours":3.5,"azureDevOpsIntegration.enableTimeTracking":true,// AI summaries"azureDevOpsIntegration.summaryProvider":"builtin",// or "openai""azureDevOpsIntegration.openAiModel":"gpt-4o-mini",// Git integration"azureDevOpsIntegration.branchNameTemplate":"feature/{id}-{title}","azureDevOpsIntegration.enableBranchCreation":true,// Work items"azureDevOpsIntegration.workItemsPerPage":50,"azureDevOpsIntegration.enableAutoRefresh":true,// Debugging"azureDevOpsIntegration.debugLogging":false,}

Note: Personal Access Tokens are stored securely in VS Code's secret store, not in settings.json.

If you encounter issues:

1. Enable Debug Logging: SetazureDevOpsIntegration.debugLogging totrue in settings
2. View Logs: RunAzure DevOps Integration: Open Logs to see detailed diagnostics
3. Copy Logs: UseAzure DevOps Integration: Copy Logs to Clipboard to share logs for support

This extension is built with modern tooling and follows VS Code extension best practices:

• TypeScript with strict type checking
• Svelte for the webview UI components
• ESBuild for fast compilation
• Comprehensive testing with unit and integration tests

npm run build# Build the extensionnpm runtest# Run unit testsnpm run test:integration# Run integration testsnpm run screenshots:capture# Generate documentation screenshots

The repository includes a Model Context Protocol (MCP) server for automation and agent integrations. Seemcp-server/README.md for details.

Pull requests welcome. Please open an issue first for substantial changes. Add tests where practical (client querying, timer edge cases) and keep logging minimal outside debug mode.

MIT License – seeLICENSE

Enjoy the extension! Feedback & feature requests are appreciated.

Watch the complete extension workflow in action – this animated demo shows the full experience from startup to viewing your work items:

What you're seeing:

1. Initializing (0.5s) – Extension activates and connects to Azure DevOps
2. Loading (0.5s) – Work items query executes with visual feedback
3. List View (1.5s) – Work items displayed in a clean, sortable list with timer controls
4. Transition (0.3s) – Smooth toggle to Kanban view
5. Kanban Board (1.7s) – Work items organized by state columns with drag-and-drop support

The extension provides clear status messages throughout, eliminating the "flash of empty state" during startup. The authentic VS Code Dark+ theme ensures the interface feels native to your editor.

• Attribution and license details: seeNOTICE andLICENSE.
• Architecture, security notes, and CI testing details: seedocs/ARCHITECTURE.md.
• What's new: seeCHANGELOG for the latest features and fixes.