Azure DevOps Integration for VS Code

Streamline your development workflow with Azure DevOps work items, time tracking, and Git integration directly in VS Code. Perfect for teams using Azure DevOps Services or DevOps Server (on-premises).

Get Help:

Copy logs: Azure DevOps Integration: Copy Logs to Clipboard
Open an issue on GitHub

🎬 See It In Action

Watch the complete workflow: Initialization → Work item queries → List and Kanban views with smooth transitions and native VS Code theming.

🚀 Key Features

📋 Work Items Management

Smart Queries: Built-in filters (My Activity, Assigned to Me, Current Sprint, All Active, Recently Updated)
Custom WIQL: Write your own queries with syntax validation and templates
Bulk Operations: Multi-select work items for batch assign, state changes, tagging, and deletion
Advanced Filtering: Save and share filter sets, export/import configurations

⏱️ Time Tracking

Smart Timer: Auto-pause on inactivity, resume when you're back
Status Bar Integration: Always visible timer with one-click controls
Automatic Updates: Sync tracked time to work item hours
Time Reports: View daily, weekly, monthly, and all-time tracking data

🔀 Git Integration

Branch Creation: Generate branches from work items with customizable naming
Pull Request Flow: Create PRs directly from your current branch
Smart Templates: Configure branch naming patterns that fit your workflow

🔐 Modern Authentication

Microsoft Entra ID: Secure OAuth 2.0 with automatic token refresh
Personal Access Tokens: Traditional PAT support with secure storage
On-Premises Support: Full compatibility with Azure DevOps Server
Connection Management: Switch between multiple organizations seamlessly

🎨 Rich Interface

Dual Views: Toggle between detailed list and visual Kanban board
Keyboard Navigation: Vim-style shortcuts (r, v, /) and multi-select, plus an insert mode toggle to pause shortcuts while typing
Accessibility: Full ARIA support and screen reader compatibility
Performance Dashboard: Real-time metrics and optimization tips

🧠 AI Integration

Work Summaries: Generate updates using Copilot prompts or OpenAI
Smart Drafts: Per-work-item draft persistence for refining messages
Timer Integration: Auto-select active work item for summaries

🛡️ Security & Trust

This extension handles your data with enterprise-grade security. For complete details on authentication, data access, and runtime security, see our Security & Trust Notice.

� Get Started in 3 Steps

1. 📥 Install

From VS Code Marketplace:

Open Extensions view (Ctrl+Shift+X)
Search "Azure DevOps Integration"
Click Install

Quick Install via Command Palette:

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

2. ⚙️ Setup

Easy Setup Wizard (Recommended):

Open Command Palette (Ctrl+Shift+P)
Run: Azure DevOps Integration: Setup Wizard (Easy)
Paste any work item URL from your Azure DevOps
Choose authentication method:
- Microsoft Entra ID (OAuth) - Modern, secure, no tokens to manage
- Personal Access Token - Traditional approach

The wizard auto-detects your organization, project, and server type!

For On-Premises: The extension fully supports Azure DevOps Server. Just use a work item URL from your server (e.g., https://myserver/DefaultCollection/MyProject/_workitems/edit/123)

3. 🎯 Start Working

Click the Azure DevOps icon in the Activity Bar
Browse work items with built-in queries or create custom WIQL
Start timers, create branches, and manage work items directly in VS Code

🔐 Authentication Options

🌟 Microsoft Entra ID (Recommended)

Perfect for Azure DevOps Services (cloud):

✅ No token management - OAuth 2.0 handles everything
✅ Auto-refresh - Never worry about expired tokens
✅ Status bar indicator - See token status at a glance
✅ One-click reconnect - Easy reauthorization when needed

� Personal Access Token

Required for on-premises, available for cloud:

Minimum required scopes:

Work Items (Read & Write)
User Profile (Read)
Team (Read)
Code (Read & Write) - for Git integration
Build (Read) - for future features

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

Note: On-premises Azure DevOps Server only supports PAT authentication. The setup wizard automatically detects this and guides you accordingly.

� Power User Features

⚡ Bulk Operations

Select multiple work items (Ctrl/Cmd+Click or checkboxes) for batch operations:

Bulk Assign - Assign multiple items to any user
Bulk Move - Change state for multiple items
Bulk Tag - Add tags with smart merge (no duplicates)
Bulk Delete - Soft delete with confirmation

🔍 Advanced Filtering

Query Builder - Interactive WIQL with 5 pre-built templates
Saved Filters - Save, manage, and share filter configurations
Export/Import - JSON-based filter sharing
Live Validation - Syntax checking with helpful error messages

📊 Performance Dashboard

Real-time Metrics - Operation stats, cache hit rates, error tracking
Memory Monitoring - Usage tracking and optimization tips
Cache Statistics - View performance improvements and recommendations

⌨️ Keyboard Shortcuts

r - Refresh • v - Toggle Kanban view • / - Focus search
Space - Toggle selection • Esc - Clear selection or exit insert mode • Ctrl+A - Select all
i / I - Enter insert mode to pause navigation shortcuts (type freely in summary/comments)
Full accessibility with screen reader support

⌨️ Essential Commands

Setup & Connection:

Azure DevOps Integration: Setup Wizard (Easy) - Guided setup with URL parsing
Azure DevOps Integration: Sign In with Microsoft Entra ID - OAuth authentication
Azure DevOps Integration: Setup Connection - Manual PAT setup

Daily Workflow:

Azure DevOps Integration: Show Work Items - Open main view
Azure DevOps Integration: Start/Stop Timer - Toggle time tracking
Azure DevOps Integration: Create Branch from Work Item - Git integration
Azure DevOps Integration: Toggle Kanban View - Switch view modes

Advanced Features:

Azure DevOps Integration: Query Builder - Build custom WIQL queries
Azure DevOps Integration: Bulk Assign Work Items - Multi-item operations
Azure DevOps Integration: Show Performance Dashboard - View metrics
Azure DevOps Integration: Show Time Report - Tracking reports

💡 Pro Tip: Press Ctrl+Shift+P and type "Azure DevOps" to see all available commands

⚙️ Configuration

Key Settings (Optional):

{
  // Time tracking
  "azureDevOpsIntegration.defaultElapsedLimitHours": 3.5,

  // AI integration
  "azureDevOpsIntegration.summaryProvider": "builtin", // or "openai"

  // Git templates
  "azureDevOpsIntegration.branchNameTemplate": "feature/{id}-{title}",

  // Performance
  "azureDevOpsIntegration.workItemsPerPage": 50,

  // Debugging
  "azureDevOpsIntegration.debugLogging": false,
}

🔒 Security: Tokens are stored securely in VS Code's secret store, never in settings files.

🔍 Troubleshooting

Having issues?

Check Debug Logs:
- Enable: Set azureDevOpsIntegration.debugLogging to true
- View: Command Palette → Azure DevOps Integration: Open Logs
Common Solutions:
- Empty work items: Verify PAT scopes and organization/project settings
- Timer issues: Confirm a work item is selected and no other timer is active
- Git integration: Ensure PAT has Code (Read & Write) permissions
Get Help:
- Copy logs: Azure DevOps Integration: Copy Logs to Clipboard
- Open an issue on GitHub

📚 Documentation & Resources

Marketplace Page - Install and reviews
Security & Trust - Security practices and data handling
Architecture Guide - Technical details and CI testing
Release Notes - Latest features and fixes
GitHub Repository - Source code and issues

🤝 Contributing

Contributions welcome! Please open an issue for substantial changes. Built with TypeScript, Svelte, and ESBuild following VS Code extension best practices.

Quick Development:

npm run build          # Build extension
npm run test           # Run tests
npm run test:integration # Integration tests

📄 Legal

License: MIT License - see LICENSE
Attribution: See NOTICE for third-party licenses
Security: Read our Security & Trust Notice for data handling details

Enjoy streamlined Azure DevOps integration! 🚀
Feedback and feature requests are always welcome.

Architecture, security notes, and CI testing details: see docs/ARCHITECTURE.md.
What's new: see CHANGELOG for the latest features and fixes.

Azure DevOps Integration for VS Code

Plures LLC

Azure DevOps Integration for VS Code

🎬 See It In Action

🚀 Key Features

📋 Work Items Management

⏱️ Time Tracking

🔀 Git Integration

🔐 Modern Authentication

🎨 Rich Interface

🧠 AI Integration

🛡️ Security & Trust

� Get Started in 3 Steps

1. 📥 Install

2. ⚙️ Setup

3. 🎯 Start Working

🔐 Authentication Options

🌟 Microsoft Entra ID (Recommended)

� Personal Access Token

� Power User Features

⚡ Bulk Operations

🔍 Advanced Filtering

📊 Performance Dashboard

⌨️ Keyboard Shortcuts

⌨️ Essential Commands

⚙️ Configuration

🔍 Troubleshooting

📚 Documentation & Resources

🤝 Contributing

📄 Legal