Azure DevOps CLI (azdocli)

🚀 Azure DevOps CLI

A command-line tool for interacting with Azure DevOps. Manage repositories, pipelines, boards, and more — built with Rust for performance and reliability.

Install Now View on GitHub ↗

azdocli

$ azdocli login

Enter organization name: mycompany

Enter PAT: ••••••••

✅ Successfully logged in to Azure DevOps

$ azdocli project MyProject

✅ Default project set to: MyProject

$ azdocli repos list

📋 Repositories in MyProject:

✅ backend-api

✅ frontend-app

✅ shared-library

Found 3 repositories

Installation

Quick Install (Recommended)

Recommended

Linux / macOS

curl -sSL https://christianhelle.com/azdocli/install | bash

Windows (PowerShell)

iwr -useb https://christianhelle.com/azdocli/install.ps1 | iex

One-command installation that automatically detects your platform, downloads the latest release, and adds it to your PATH.

From crates.io

Rust

cargo install azdocli

For users with Rust tooling installed. Compiles and installs from crates.io.

Snap Store (Linux)

snap install azdocli

Install directly from the Snap Store on Linux systems with automatic updates.

GitHub Releases

Download pre-built binaries for your platform:

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

Build from Source

Dev

Requires Rust 1.70 or later.

git clone https://github.com/christianhelle/azdocli.git
cd azdocli
cargo build --release

Features

📁

Repository Management

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

🔧

Pipeline Management

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

📋

Board Management

Full CRUD operations for work items with advanced filtering, 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.

📂

Project Management

Create, delete, list, and show Azure DevOps team projects within an organization.

🔄

Migration

Cross-tenant team-project migration with azdocli migrate for moving projects between organizations.

🖥️

Enterprise Support

Quick Start

Authentication

Before using the CLI, create a Personal Access Token (PAT) in Azure DevOps with the required scopes: Code (read/write), Build (read/execute), Work Items (read/write), and Project and Team (read).

              # Login with your Personal Access Token
azdocli login
# You'll be prompted for:
# - Organization name (e.g., "mycompany" from https://dev.azure.com/mycompany)
# - Personal Access Token

# Set a default project (optional but recommended)
azdocli project MyProject
            

Common Commands

              # Repository management
azdocli repos list
azdocli repos show --id MyRepo
azdocli repos clone --target-dir ./repos --parallel

# Pull request management
azdocli repos pr list --repo MyRepo
azdocli repos pr show --repo MyRepo --id 123
azdocli repos pr create --repo MyRepo --source "feature/x" --title "My Feature"
azdocli repos pr update --repo MyRepo --id 123 --title "New title"

# Pipeline management
azdocli pipelines list
azdocli pipelines runs --id 42
azdocli pipelines run --id 42

# Board management
azdocli boards work-item list
azdocli boards work-item show --id 123
azdocli boards work-item create bug --title "Fix login issue"

# Project management
azdocli projects list
azdocli projects create --name MyProject
            

Ready to dive deeper?

Read the User Guide