@nahuelcio/opencode-ado

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

• npm package
• GitHub repository
• Azure DevOps docs