adtk repos

The repos command group lets you list, inspect, browse Git repositories, view branch policies, and manage tags in Azure DevOps.

Shared Flags

Flag	Short	Description
`--project`	`-p`	Project name

list

List all repositories in a project.

adtk repos list [--project myproject]

NAME              DEFAULT BRANCH     SIZE      REMOTE URL
backend-api       refs/heads/main    52840     https://dev.azure.com/myorg/MyProject/_git/backend-api
frontend-app      refs/heads/main    38120     https://dev.azure.com/myorg/MyProject/_git/frontend-app

2 repositories

get

Get detailed information about a specific repository.

adtk repos get <repo> [--project myproject]

Example:

adtk repos get backend-api -p MyProject

  ID:             a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Name:           backend-api
  Default Branch: refs/heads/main
  Size:           52840 bytes
  Remote URL:     https://dev.azure.com/myorg/MyProject/_git/backend-api
  Web URL:        https://dev.azure.com/myorg/MyProject/_git/backend-api
  Project:        MyProject

branches

List branches for a repository.

adtk repos branches <repo> [--project myproject]

Example:

adtk repos branches backend-api -p MyProject

NAME                  OBJECT ID
refs/heads/main       a1b2c3d4e5f6
refs/heads/develop    f6e5d4c3b2a1

2 branches

tree

List files and directories in a repository path.

adtk repos tree <repo> [path] [--project myproject]

Example:

adtk repos tree backend-api /src -p MyProject

TYPE    PATH
tree    /src/handlers
tree    /src/models
blob    /src/main.go
blob    /src/config.go

commits

Search commits in a repository. Outputs raw JSON.

adtk repos commits <repo> [--project myproject] [--author name] [--from date] [--to date]

Flag	Description
`--author`	Filter by commit author
`--from`	Filter commits from this date
`--to`	Filter commits to this date

Example:

adtk repos commits backend-api -p MyProject --author "Jane" --from "2025-01-01"

policies

List branch policies for a repository. Outputs raw JSON.

adtk repos policies <repo> [--project myproject]

Example:

adtk repos policies backend-api -p MyProject