adtk CLI Overview

adtk provides a full-featured command-line interface for Azure DevOps. All commands support a --json flag for raw JSON output, making them composable with other tools.

Authentication

Before using any command, authenticate with adtk auth or set the AZURE_DEVOPS_ORG and AZURE_DEVOPS_PAT environment variables.

Global Flags

Flag	Description
--json	Output raw JSON instead of formatted tables
--version	Print adtk version

Command Groups

Command	Aliases	Description
auth		Authenticate with Azure DevOps
status		Show current authentication status
logout		Log out and remove stored credentials
mcp		Start the MCP server (stdio or HTTP)
work-items	wi	Manage work items (get, list, types, my, comments, metrics)
repos		Manage Git repositories (list, get, branches, tree, commits, policies, tags)
pull-requests	pr, prs	Manage pull requests (list, get, reviewers)
pipelines	pipe	Manage CI/CD pipelines (list, get, runs, definitions, var-groups, environments)
wiki		Manage wiki pages (list, get, pages)
search		Search code, work items, WIQL, and saved queries
iterations	iter, sprints	Manage iterations/sprints (list, current, settings)
boards		Manage Kanban boards (list, columns)
projects	proj	Manage projects and teams (list, get, teams)
attachments	attach	Manage work item attachments (list)
test-plans	tp	Manage test plans, suites, and cases
security		Manage Advanced Security alerts

Tip

Most commands that operate within a project accept a --project or -p flag. Some commands like projects list work at the organization level and don’t require it.