ADO Tasks Notifier

Get instant notifications in VS Code when new Azure DevOps tasks are assigned to you! 🔔

✨ Features

• 🔔 Real-time notifications when new tasks are assigned
• 🤖 Smart categorization - Automatically detects task type (Bug, Feature, Test, etc.)
• 🎯 Priority detection - Highlights urgent/critical tasks
• 🎨 Color-coded icons - Visual indicators for different task types
• 🚀 One-click access - Open tasks directly from notifications

Quick Start

1. Install the Extension

Open VS Code and install this extension:

• Press Ctrl+Shift+X to open Extensions
• Search for "Azure DevOps Workitem Notifier"
• Click Install

2. Get Your Personal Access Token (PAT)

You need a PAT to connect to Azure DevOps:

1. Go to Azure DevOps
2. Click your profile picture (top right) → Personal access tokens
3. Click + New Token
4. Fill in:
   • Name: VS Code Notifier
   • Expiration: Choose duration (90 days recommended)
   • Scopes: Check Work Items → Read
5. Click Create
6. Copy the token (you won't see it again!)

3. Configure the Extension

Open VS Code Settings:

• Press Ctrl+, (or File → Preferences → Settings)
• Search for "workitem"
• Fill in only these 2 fields:
  • Ado User Email: Your work email (e.g., your.name@company.com)
  • Ado Pat: Paste the token you copied above

That's it! The extension will automatically start monitoring for new tasks.

4. Verify It's Working

To confirm notifications are enabled:

1. Open Command Palette (Ctrl+Shift+P)
2. Type and run: "Start Azure DevOps Task Monitoring"
3. You should see a message: "Started monitoring Azure DevOps tasks"
4. Check the Output panel:
   • Go to View → Output
   • Select "Extension Host" from the dropdown
   • You should see: "Starting Azure DevOps polling..." and "Polling Azure DevOps for: your.email@company.com"

5. Test the Notification

To test if notifications work:

1. Ask a teammate to assign you a new task in Azure DevOps
2. Within 10 seconds, you should see a notification pop up in VS Code (bottom right corner)
3. The notification will show the task with a smart category icon and priority:
   • 🐛 Bug: "Fix login error"
   • ✨ Feature: "Add export button"
   • 🔴 High Priority: Tasks marked urgent/critical will have a red indicator
4. Click "Open Task" to view it in your browser

🤖 Smart Categorization

The extension automatically categorizes tasks based on keywords:

Priority Detection: Tasks with keywords like "urgent", "critical", "asap", or "blocker" get a 🔴 indicator.

How It Works

Once configured:

• The extension checks Azure DevOps every 10 seconds for new tasks assigned to you
• When a new task is found, you'll see a notification in VS Code
• Click "Open Task" to view it in your browser
• Click "Dismiss" to close the notification

Important: The extension only notifies you about NEW tasks assigned after it starts monitoring. Tasks that were already assigned before won't trigger notifications.

Commands

You can manually control the extension using the Command Palette (Ctrl+Shift+P):

• Start Azure DevOps Task Monitoring - Start monitoring
• Stop Azure DevOps Task Monitoring - Stop monitoring

Troubleshooting

Not receiving notifications?

1. Check the Output panel (View → Output → Select "Extension Host") for errors
2. Verify your email exactly matches your Azure DevOps profile
3. Make sure your PAT has Work Items (Read) permission
4. Try running the command "Start Azure DevOps Task Monitoring"

Need to change settings?

Press Ctrl+, and search for "workitem" to update your email or PAT.

Configuration Details

The extension is pre-configured for:

• Organization: MarsDevTeam
• Project: RoyalCaninTestFactory

If you need to change these, search for "workitem" in Settings and modify:

• Workitem Chatbot: Ado Org
• Workitem Chatbot: Ado Project

Privacy & Security

• Your PAT is stored securely in VS Code settings
• The extension only reads work items assigned to you
• No data is sent to any third party

Support

Having issues? Contact your team admin or check the extension's marketplace page for updates.

Happy coding! 🚀