@cioffinahuel/opencode-ado

Azure DevOps plugin for OpenCode + Pi.

Install

OpenCode

npx @cioffinahuel/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:@cioffinahuel/opencode-ado

Then create config with:

/ado:config

CLI

npx @cioffinahuel/opencode-ado init       # interactive setup wizard
npx @cioffinahuel/opencode-ado sync       # register existing ADO config in OpenCode + TUI
npx @cioffinahuel/opencode-ado show       # show current config
npx @cioffinahuel/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": [
    [
      "@cioffinahuel/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

Migration: renamed tools (v0.5.x → v0.6.0)

| Old name | New name | |---|---| | ado_prs | ado_pr_list | | ado_pr | ado_pr_get | | ado_review | ado_pr_vote | | ado_select_pr | ado_pr_select | | ado_pr_review_context | ado_pr_context | | ado_create_pr | ado_pr_create | | ado_chain_prs | ado_pr_chain | | ado_work_items | ado_wi_list | | ado_work_item | ado_wi_get | | ado_work_item_update | ado_wi_update | | ado_work_item_comment | ado_wi_comment | | ado_work_item_types | ado_wi_types | | ado_create_work_item | ado_wi_create | | ado_create_child_work_item | ado_wi_create_child | | ado_related_work_items | ado_wi_related | | ado_profile | ado_profile_get | | ado_profiles | ado_profile_list |

Current tool names

• ado_pr_list
• ado_pr_get
• ado_pr_threads
• ado_pr_comment
• ado_pr_vote
• ado_pr_diff
• ado_pr_file
• ado_pr_context
• ado_pr_select
• ado_pr_create
• ado_pr_chain
• ado_profile_get
• ado_profile_list
• ado_profile_use
• ado_wi_list
• ado_wi_get
• ado_wi_update
• ado_wi_comment
• ado_wi_types
• ado_wi_create
• ado_wi_create_child
• ado_wi_related

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