Releases: gilbertwong96/ado_cli
AdoCli v0.4.12
AdoCli v0.4.12
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
See README.md for
installation instructions.
AdoCli v0.4.11
AdoCli v0.4.11
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
Fixed
ado prs diff ... --unified | head -n 220failed in Burrito binaries
with "Failed to write log message to stdout, trying stderr". Root
cause was a Burrito wrapper bug: CLI args were joined with spaces into
theADO_ARGSenv var, which broke args containing spaces (e.g. project
names like"Employee Management"). The Burrito fork has been fixed
upstream — args now flow via native argv (after-extra) and reach the
BEAM through:init.get_plain_arguments/0.ado_cliupdated to match.
Verified: quoted args parse correctly and piping toheadworks in both
escript and Burrito binaries.
See README.md for
installation instructions.
AdoCli v0.4.10
AdoCli v0.4.10
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
Added
--end-linefor multi-line codeblock comments.ado prs comments add
now supports--line START --end-line ENDto comment on a range of lines
instead of a single line.
Fixed
- Inline comments showed "file no longer exists" warning. The
filePath
inthreadContextwas missing a leading/, causing Azure DevOps to not
setchangeTrackingId. Theensure_leading_slash/1helper now normalizes
user input automatically — bothsrc/foo.exand/src/foo.exwork.
See README.md for
installation instructions.
AdoCli v0.4.9
AdoCli v0.4.9
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
See README.md for
installation instructions.
AdoCli v0.4.8
AdoCli v0.4.8
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
Fixed
-
prs difffailed for new/deleted files against real Azure DevOps API.
Thechange_type/1function matched only integerchangeTypevalues (1, 2, 4),
but the real API returns strings ("add","edit","delete"). The
404-tolerance logic never activated. Now handles both string and integer formats
across theiterations/{i}/changesand/diffs/commitsendpoints. -
Hunk headers were wrong for new and deleted files.
@@ -1,1instead of
@@ -0,0for new files, with a spurious empty deletion line. Empty content
now maps to[]for correct headers. -
just bumpdid not updategithub-page/index.htmlwhen the version was
already stale. The sed pattern matched only the immediately-previous version.
Now uses a semver-generic regex to catch any stale references.
See README.md for
installation instructions.
AdoCli v0.4.7
AdoCli v0.4.7
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
Fixed
-
prs diff --filereturned 404 for new files (2 fixes). Two related bugs:- For files added in a PR (changeType
add), the Azure DevOps/itemsAPI
returns 404 when fetching content at the base commit. The diff pipeline
now tolerates these 404s and uses empty content. Same for deleted files. - The
--filepath argument (e.g.src/foo.ex) was sent directly to the
API without a leading/, causing 404s even for existing files. The
canonical API path from the change list is now used.
- For files added in a PR (changeType
-
prs diff --unifieddropped new and deleted files. The unified diff
mode silently skipped files where the old or new content fetch failed.
Now correctly includes new and deleted files in the output. -
just bumpdid not update skill version frontmatter. The
priv/skills/*/SKILL.mdYAML headers were excluded from the bump script,
requiring manual updates. They are now bumped in lockstep withmix.exs.
Changed
-
ado login --method deviceno longer requires--org. The org
is auto-detected from the token, matching the browser flow behavior.
ado loginwith no flags works for both browser and device code flows. -
Login help text and skills updated to guide users toward the
simplest workflow:ado login(no flags).
See README.md for
installation instructions.
AdoCli v0.4.6
AdoCli v0.4.6
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
Fixed
prs diff --filereturned 404 for new files. For files added in a
PR (changeTypeadd), the Azure DevOps/itemsAPI returns 404 when
fetching the file at the base commit (the file did not exist yet). The
diff pipeline now tolerates 404 on the old-content side for new files
and on the new-content side for deleted files, using empty content.prs diff --unifieddropped new and deleted files. The unified diff
mode (collect_diffs) silently skipped files where either the old or new
content fetch failed. It now correctly includes new and deleted files.
See README.md for
installation instructions.
AdoCli v0.4.5
AdoCli v0.4.5
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
Fixed
- Work items
listreturned empty Type/Title columns. WIQL queries
return bare{id, url}refs without field data. Addedfetch_work_items_batch
to batch-fetch full work item details by IDs for rich table output. - Work items
listWIQL clause ordering was broken. The internal query
builder producedORDER BY ... WHERE ... FROM WorkItems SELECT ...instead
of the correctSELECT ... FROM WorkItems WHERE ... ORDER BY ...order.
Rewrote the pipeline to build clauses in the proper order. - Work items
createandupdatereturned "content-type not supported".
The Azure DevOps work items API requiresapplication/json-patch+json,
butClient.post/patchalways sentapplication/json. Extended both
functions to accept an optional content type parameter. - Work items
update --tagsappended instead of replacing. The JSON-Patch
op: "add"onSystem.Tagsappends tags in Azure DevOps. Changed
update_work_itemto useop: "replace"to match the documented
"replaces all" behavior. Client.do_request_with_authexceeded Credo's max arity of 8. Merged
organdauth_headersinto a single tuple parameter.
AdoCli v0.4.4
What's New in v0.4.4
This release fixes the multi-word --content parsing issue and overhauls
documentation across the CLI and skills for LLM agent consumption.
Fixed
ado prs comments add --contentaccepts unquoted multi-word text.
Elixir 1.18+OptionParserin strict mode consumes only one token after
a flag, so--content Code review approvedparsed ascontent="Code"
and["review", "approved"]as extra positional args, which CliMate
rejected withunexpected extra argument review. Added a pre-parse
pass inAdoCli.CLI.run/1that detects flags in@multivalue_opts
(--content,--message,--body,--description,--reason,
--summary,--text) and joins all subsequent non-flag tokens into
a single value using the--flag=valuesyntax. 12 new unit tests
cover single-word, multi-word,--status-after,=,-,@file
and combination cases.
Documentation
- Enriched
--helptext across all 27 command modules. Every option
doc:string now includes valid values for enums, default behavior
hints, output format descriptions, and argument format hints (GUID
vs numeric ID vs name). Example:state: "wellFormed, creating, deleting, new, all"instead ofFilter by project state. - Rewrote all 3 skills for LLM agent consumption. Each skill now
has a decision tree, structured command reference, common pitfalls
table with specific error messages and version-specific fixes, and
cross-references. Bumped to v0.4.3 to match the CLI version. New
sections include binary download matrix (5 platforms in ado-ci), PAT
scope table, troubleshooting matrix (ado-auth), and JSON output
examples (ado-cli). - Updated help text to document the new multi-word flag behavior.
prs comments add --helpandprs comments update --helpnow show:
"Multi-word values do NOT need quoting — all subsequent args are
joined until the next flag. Use @ to read from a file or-
to read from stdin."
Tests
- 12 new tests in
test/ado_cli/cli_test.exsfor the multi-word flag
join behavior. 337 tests pass, credo clean, dialyzer clean.
Binaries
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-0.4.4-linux-x86_64 |
| Linux | aarch64 | ado-0.4.4-linux-aarch64 |
| macOS | Apple Silicon | ado-0.4.4-macos-aarch64 |
| macOS | Intel | ado-0.4.4-macos-x86_64 |
| Windows | x86_64 | ado-0.4.4-windows-x86_64.exe |
Installation
# macOS arm64 (Apple Silicon)
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.4-macos-aarch64
chmod +x ado && sudo mv ado /usr/local/bin/
# Linux x86_64
curl -L -o ado https://github.com/gilbertwong96/ado_cli/releases/latest/download/ado-0.4.4-linux-x86_64
chmod +x ado && sudo mv ado /usr/local/bin/
# Or via npm
npm install -g @gilbertwong1996/adoSee README.md and the
project homepage for
full installation instructions and usage examples.
What's Changed
6a63f35docs: enrich --help and skills for LLM consumption3e47310fix(cli): support unquoted multi-word --content values
Full Changelog: https://github.com/gilbertwong96/ado_cli/blob/main/CHANGELOG.md
AdoCli v0.4.3
AdoCli v0.4.3
Pre-built binaries for all supported platforms.
| Platform | Architecture | Binary |
|---|---|---|
| Linux | x86_64 | ado-*-linux-x86_64 |
| Linux | aarch64 | ado-*-linux-aarch64 |
| macOS | Apple Silicon | ado-*-macos-aarch64 |
| macOS | Intel | ado-*-macos-x86_64 |
| Windows | x86_64 | ado-*-windows-x86_64.exe |
See README.md for
installation instructions.