🚀 Azure DevOps CLI

A powerful command-line interface for Azure DevOps

Build Status Security Audit

Overview

Azure DevOps CLI is a command-line tool that provides seamless interaction with Azure DevOps services. Built with Rust for performance and reliability, it offers comprehensive features for managing repositories, pipelines, boards, and more.

🌟 Key Features

📁 Repository Management

List, create, delete, clone, view, and manage pull requests in repositories with powerful batch operations and parallel processing.

🔧 Pipeline Management

Manage Azure DevOps pipelines, view runs, show build details, and trigger new executions directly from the command line.

📋 Board Management

Comprehensive work item management with full CRUD operations, support for multiple work item types, and web integration.

🔐 Secure Authentication

Secure login using Personal Access Tokens (PAT) with proper credential management and session handling.

⚡ Default Project

Set a default project to streamline your workflow and avoid specifying --project for every command.

🚀 Performance

Built with Rust for exceptional performance, with parallel operations and efficient resource utilization.

📦 Installation

From crates.io

cargo install azdocli

The easiest way to install. This will install the ado binary.

From GitHub Releases

Download pre-built binaries:

  • Windows: windows-x64.zip or windows-arm64.zip
  • macOS: macos-x64.zip or macos-arm64.zip
  • Linux: linux-x64.zip or linux-arm64.zip

Download Latest Release

💻 Quick Start

1. Create a Personal Access Token

Before using the CLI, you need to create a Personal Access Token (PAT) in Azure DevOps:

  1. Navigate to Azure DevOps → User Settings → Personal Access Tokens
  2. Click "New Token"
  3. Set a descriptive name (e.g., "azdocli")
  4. Configure the required scopes: Code (read & write), Build (read & execute), Work Items (read & write)
  5. Click "Create" and copy the token securely

⚠️ Important: Store your PAT securely and never commit it to version control.

2. Login to Azure DevOps

ado login

Enter your organization name and the PAT you created in step 1 when prompted.

3. Set a default project (optional)

ado project MyProject

4. Start using the CLI

# Repository management
ado repos list
ado repos show --id MyRepo
ado repos clone

# Pull request management  
ado repos pr list --repo MyRepo
ado repos pr create --repo MyRepo --source "feature/my-feature" --title "My Feature"

# Pipeline management
ado pipelines list
ado pipelines runs --id 42