@@ -3,6 +3,10 @@ name: ado-cli
33description : Main ado skill — setup, authentication, and complete command reference for all 24 service areas
44version : " 0.4.0"
55commands :
6+ - ado --version
7+ - ado version
8+ - ado schema
9+ - ado completion bash
610 - ado login --org ORG
711 - ado login --method pat --org ORG --pat TOKEN
812 - ado logout
@@ -37,6 +41,9 @@ commands:
3741 - ado prs complete PROJECT REPO ID --merge-strategy squash
3842 - ado prs approve PROJECT REPO ID
3943 - ado prs comments list PROJECT REPO PR_ID
44+ - ado prs comments add PROJECT REPO PR_ID --content TEXT
45+ - ado prs comments update PROJECT REPO PR_ID THREAD COMMENT --content TEXT
46+ - ado prs diff PROJECT REPO PR_ID
4047 - ado releases list PROJECT
4148 - ado releases show PROJECT ID
4249 - ado iterations list PROJECT
@@ -60,6 +67,7 @@ commands:
6067 - ado skills describe NAME # skill frontmatter + command index
6168 - ado skills read NAME # full skill content
6269 - ado skills search "QUERY" # find skill by topic
70+ - ado skills install # embed all skills to LLM agents
6371---
6472
6573# ado
@@ -98,6 +106,9 @@ The CLI auto-detects the org from the token if `--org` is omitted.
98106| Group | Subcommands |
99107| -------| -------------|
100108| ` login ` , ` logout ` , ` whoami ` | Authentication & status |
109+ | ` version ` | Print the CLI version (` --version ` flag also works) |
110+ | ` schema ` | Dump the full command tree as JSON for LLM discovery |
111+ | ` completion ` | Shell completion: bash, zsh, fish, powershell |
101112| ` projects ` | list, show, create, update, delete |
102113| ` repos ` | list, show, create, delete |
103114| ` branch-policies ` | list, show, create, update, delete |
@@ -108,7 +119,9 @@ The CLI auto-detects the org from the token if `--org` is omitted.
108119| ` pipelines-builds ` | Classic builds: list, show, queue, cancel, tags, definitions |
109120| ` pipelines-folders ` | Folders: list, create, delete |
110121| ` pipelines-artifacts ` | Run artifacts: list, download |
111- | ` prs ` | list, show, create, complete, abandon, approve, vote, comments |
122+ | ` ci ` | CI pipeline watching: ` ci watch ` (live status + streaming logs) |
123+ | ` prs ` | list, show, create, complete, abandon, approve, vote, diff, comments |
124+ | ` prs comments ` | Threads: add (new/reply), list (with --all), update (content/status) |
112125| ` releases ` | list, show, create, update |
113126| ` iterations ` | Sprints: list, show, create, update, delete |
114127| ` areas ` | Area paths: list, show, create, update, delete |
@@ -122,7 +135,7 @@ The CLI auto-detects the org from the token if `--org` is omitted.
122135| ` security permissions ` | ACLs: list, namespaces |
123136| ` banners ` | Org-wide notifications: show, set, delete |
124137| ` packages ` | Universal Packages: list, versions, show |
125- | ` skills ` | list, read |
138+ | ` skills ` | list, describe, read, search, install (embed for LLM agents) |
126139
127140## Conventions
128141
@@ -160,6 +173,16 @@ ado workitems create MyProject --type Bug --title "Fix login page"
160173# Create a PR
161174ado prs create MyProject MyRepo --title " Add feature" --source dev --target main
162175
176+ # View PR changes (3 modes: file list, per-file, unified diff)
177+ ado prs diff MyProject MyRepo 42
178+ ado prs diff MyProject MyRepo 42 --file src/app.ex
179+ ado prs diff MyProject MyRepo 42 --unified | delta
180+
181+ # Review PR comments
182+ ado prs comments add MyProject MyRepo 42 --content " LGTM!"
183+ ado prs comments list MyProject MyRepo 42 --all
184+ ado prs comments update MyProject MyRepo 42 7 5 --content " updated" --status fixed
185+
163186# Trigger a pipeline with variables
164187ado pipelines run MyProject 42 --branch main --variables " ENV=staging,DEBUG=true"
165188
@@ -176,6 +199,17 @@ ado projects list
176199
177200# Check auth status
178201ado whoami
202+
203+ # Print version (or use --version flag)
204+ ado version
205+ ado --version
206+
207+ # Dump the full command tree for LLM agents
208+ ado schema --json | jq ' .schema.subcommands | length'
209+
210+ # Install shell completion (bash/zsh/fish/powershell)
211+ ado completion bash | eval
212+ ado completion zsh > " ${fpath[1]} /_ado"
179213```
180214
181215## Help
0 commit comments