@cioffinahuel/opencode-ado
v9.4.0
Published
Azure DevOps CLI — PR reviews, work items, pipelines, profiles
Maintainers
Readme
@cioffinahuel/opencode-ado
Azure DevOps CLI — PRs, reviews, work items, pipelines and multi-project
profiles behind one ado binary. Pairs with the ado agent skill so AI coding
agents drive Azure DevOps by running commands.
Install
npm i -g @cioffinahuel/opencode-ado # provides the `ado` command
ado init # org + PAT + profiles
npx skills add nahuelcio/ado-plugin # agent skill (Claude Code, OpenCode, Codex, …)Configuration
Profiles live in ~/.azure-devops-cli/config.json:
{
"ado": {
"defaultProfile": "work",
"profiles": {
"work": {
"org": "https://dev.azure.com/myorg",
"project": "myproject",
"patEnvVar": "AZURE_DEVOPS_PAT",
"repos": ["backend", "frontend"]
}
}
}
}Lookup order: [ado] table in the project's .adoconfig.toml →
~/.azure-devops-cli/config.json → legacy OpenCode config (migrated on first use).
Authentication
Requires an Azure DevOps PAT with scopes Code (R/W), Pull Request Contribute (R/W) and Work Items (Read).
PAT resolution order:
- The profile's
pat - The env var named by the profile's
patEnvVar(AZURE_DEVOPS_PATby default) ~/.azure-devops-cli/pat(written byado init)
Usage
ado --help # all groups
ado <group> --help # commands and flags of a groupFull documentation: project README.
Upgrading from 0.x
1.0 removes the OpenCode/Pi plugin, its ado_* tools and the TUI sidebar. Remove
the package from the plugin arrays in opencode.json / tui.json; profiles
are migrated automatically.
Development
npm install
npm run build
npm testLicense
MIT
