ADO Intelligent Agent

A Visual Studio Code extension that provides intelligent integration with Azure DevOps (ADO). This extension helps developers streamline their workflow by providing direct access to Azure DevOps work items, build tasks, and project management features from within VS Code.

🚀 Features

• Azure DevOps Connection: Seamless integration with your ADO organization
• Work Item Management: View and interact with work items directly in VS Code
• Build Task Integration: Access to build pipeline information
• Intelligent Suggestions: Smart recommendations based on your project context
• Extensible Architecture: Built for future enhancements and customization

📋 Prerequisites

• Node.js (LTS version recommended) - Download here
• Visual Studio Code v1.74.0 or higher
• Azure DevOps Account with appropriate permissions
• Personal Access Token for ADO authentication

🔧 Installation & Setup

⚠️ IMPORTANT: Node.js must be installed first!

Quick Start

1. Install Node.js from nodejs.org
2. Run setup.bat to install dependencies
3. Run build.bat to compile and package the extension

Manual Installation

# Install dependencies
npm install

# Install Visual Studio Code Extension CLI
npm install -g vsce

# Compile the extension
npm run compile

# Package the extension
npm run package

This creates ado-intelligent-agent-1.1.1.vsix which can be installed in VS Code.

🎯 Available Commands

Access these commands via Command Palette (Ctrl+Shift+P):

• ADO Agent: Hello World - Test the extension functionality
• ADO Agent: Connect to Azure DevOps - Configure your ADO connection
• ADO Agent: Get Work Items - Retrieve and display work items

⚙️ Configuration

Configure the extension in VS Code Settings:

{
  "ado-intelligent-agent.organizationUrl": "https://dev.azure.com/yourorganization",
  "ado-intelligent-agent.personalAccessToken": "your-personal-access-token"
}

🏗️ Development

Project Structure

src/
├── extension.ts              # Main extension entry point
└── services/
    └── adoService.ts        # Azure DevOps integration service

Development Commands

• npm run compile - Compile TypeScript
• npm run watch - Watch mode compilation
• npm run lint - Run ESLint
• npm run package - Create VSIX package
• npm run build - Full build process

Version Management

• npm run version:patch - Bump patch version (1.1.1 → 1.1.2)
• npm run version:minor - Bump minor version (1.1.1 → 1.2.0)
• npm run version:major - Bump major version (1.1.1 → 2.0.0)
• npm run release:patch - Bump version + compile + package
• npm run release:minor - Bump version + compile + package
• npm run release:major - Bump version + compile + package

See VERSION_GUIDE.md for detailed version management instructions.

Running in Development

1. Open project in VS Code
2. Press F5 to launch Extension Development Host
3. Test commands in the new VS Code window

📚 Documentation

For detailed setup instructions, see SETUP.md

🔧 Troubleshooting

Common Issues

• "npm is not recognized" → Install Node.js
• "vsce is not recognized" → Run npm install -g vsce
• Build errors → Ensure all dependencies are installed

📈 Version History

• 1.1.1: Enhanced release with Azure DevOps integration, multiple commands, and improved architecture
• 1.0.0: Initial release with basic structure

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

This project is licensed under the MIT License.

🔗 Links

• Azure DevOps API Documentation
• VS Code Extension API
• Node.js Downloads