@gilbertwong1996/ado
v0.7.0
Published
AI-native Azure DevOps CLI — structured JSON output, embedded skills for LLM agents, single-file cross-platform binary.
Maintainers
Readme
@gilbertwong1996/ado
AI-native Azure DevOps CLI — structured JSON output, embedded skills for LLM agents, single-file cross-platform binary.
This is the npm distribution of ado.
The main package picks the right platform binary (via optionalDependencies)
and execs it.
Install
npm install -g @gilbertwong1996/ado --foreground-scripts--foreground-scripts lets the postinstall run on npm 11+, where lifecycle
scripts are gated: it downloads the release archive for the running platform and
installs shell completion. The platform packages are optionalDependencies, so a
normal install already carries the right binary.
Then:
ado --help
ado login --org myorg
ado projects list --json
ado schema --json
ado skills install --target piFeatures
- AI-native —
--jsonon every command, stable error codes, self-discoverable command tree (ado schema --json). - Embedded skills for LLM agents —
ado skills list/read/searchexpose the skill catalog.ado skills installcopies the skills into~/.pi/agent/skills/,~/.claude/skills/,~/.cursor/skills/or~/.codex/skills/so the agent loads them natively. - 24 service areas — projects, repos, work items, pipelines, builds, pull requests, packages, security, agent pools, branches, wikis, service connections, etc.
- 3 auth methods — PAT, browser OAuth (PKCE), device code. MSA personal
accounts supported. No
azCLI dependency. - CI/CD friendly —
ado ci watch PROJECT BUILD_IDstreams build logs in real time. - Cross-platform — single self-contained binary for macOS (arm64/x86_64), Linux (x86_64/aarch64), and Windows x86_64. No runtime dependencies.
Layout
The main package is a Node.js launcher (bin/ado) that resolves the platform
package and execs its binary. The platform packages carry the unpacked binary
(bin/ado, or bin/ado.exe on Windows) for one target each: darwin-arm64,
darwin-x64, linux-arm64, linux-x64, win32-x64. When npm skips the
optional dependency (--omit=optional), the postinstall fetches the matching
cargo-dist archive instead.
Documentation
See the full README on GitHub for the complete command reference.
License
Apache-2.0 — see LICENSE.
