@nahuelcio/opencode-ado

Azure DevOps plugin for OpenCode — PR reviews, profiles, sidebar panel

Packages

Package details

extension

Install @nahuelcio/opencode-ado from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@nahuelcio/opencode-ado
Package
@nahuelcio/opencode-ado
Version
0.4.4
Published
May 12, 2026
Downloads
3,608/mo · 738/wk
Author
ncioffi
License
MIT
Types
extension
Size
408.8 KB
Dependencies
4 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/pi-entry.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@nahuelcio/opencode-ado

npm version

Azure DevOps plugin for OpenCode + Pi.

Install

OpenCode

npx @nahuelcio/opencode-ado init

This wizard:

  • stores your PAT in ~/.azure-devops-cli/pat
  • registers the server plugin in ~/.config/opencode/opencode.json
  • registers the sidebar plugin in ~/.config/opencode/tui.json

Pi

pi install npm:@nahuelcio/opencode-ado

Then create config with:

/ado:config

CLI

npx @nahuelcio/opencode-ado init       # interactive setup wizard
npx @nahuelcio/opencode-ado sync       # register existing ADO config in OpenCode + TUI
npx @nahuelcio/opencode-ado show       # show current config
npx @nahuelcio/opencode-ado --help     # help

For local workspace testing (without publishing):

node dist/bin/opencode-ado.js sync-local

Configuration

OpenCode (~/.config/opencode/opencode.json)

The plugin config is stored in OpenCode as plugin options:

{
  "plugin": [
    [
      "@nahuelcio/opencode-ado",
      {
        "defaultProfile": "work",
        "profiles": {
          "work": {
            "org": "https://dev.azure.com/myorg",
            "project": "myproject",
            "patEnvVar": "AZURE_DEVOPS_PAT",
            "repos": ["backend", "frontend"],
            "default": true
          }
        }
      }
    ]
  ]
}

Pi (~/.azure-devops-cli/config.json or .pi/settings.json)

{
  "ado": {
    "defaultProfile": "work",
    "profiles": {
      "work": {
        "org": "https://dev.azure.com/myorg",
        "project": "myproject",
        "patEnvVar": "AZURE_DEVOPS_PAT",
        "repos": ["backend", "frontend"]
      }
    }
  }
}

Pi config lookup order:

  1. .pi/settings.json (project-local)
  2. ~/.pi/agent/settings.json (global)
  3. ~/.azure-devops-cli/config.json (shared fallback)

Authentication

Requires an Azure DevOps PAT with scopes:

  • Code (Read & Write)
  • Pull Request Contribute (Read & Write)
  • Work Items (Read)

PAT resolution order:

  1. AZURE_DEVOPS_PAT environment variable
  2. ~/.azure-devops-cli/pat

Available Tools

  • ado_prs
  • ado_pr
  • ado_pr_threads
  • ado_pr_comment
  • ado_review
  • ado_pr_diff
  • ado_pr_file
  • ado_pr_review_context
  • ado_select_pr
  • ado_profile
  • ado_profiles
  • ado_profile_use
  • ado_work_items
  • ado_work_item
  • ado_work_item_update
  • ado_work_item_comment
  • ado_work_item_types
  • ado_related_work_items

Pi Commands

  • /ado:status — show ADO connection status
  • /ado:profiles — list configured profiles
  • /ado:switch — switch active profile
  • /ado:config — write config template to ~/.azure-devops-cli/config.json

Development

npm install
npm run build
npm test

License

MIT

Links