ENGLISH | 日本語

Azure DevOps Extension EN

Note This extension is under development.

A VS Code extension to interact with Azure DevOps from the sidebar.

Key Features

• Browse organizations, projects, sprints, work items, and repositories in the sidebar
• View work items in a parent-child hierarchy (Epic → Feature → Story → Task) with filter support
• Clone repositories with automatic PAT embedding
• View branches and pull requests per repository with filter support
• View pipeline run history per repository with filter support (All / Running / Failed / Succeeded)
• Create a pull request from a branch with source branch pre-filled
• Send work items to GitHub Copilot Chat
• Create branches for work items automatically from the tree view
• Assign or unassign work items directly from the tree view
• Type AB# or ab# in the git commit message input to pick a work item from Azure Boards
• PAT is stored securely in VS Code Secret Storage

Installation

1. Open Extensions in VS Code (Ctrl+Shift+X)
2. Search for "Azure DevOps Extension" and click Install

Setup

Step 1: Get a PAT

1. Go to dev.azure.com
2. User settings > Personal access tokens > New Token
3. Select the following scopes:
   • Project and Team (Read)
   • Work Items (Read&Write)
   • Code (Read)
   • Build (Read)
4. Copy the token

Step 2: Add an Organization

1. Click the Azure DevOps Extension icon in the VS Code sidebar
2. Click the + icon at the top of the panel
3. Enter your organization name and PAT

Usage

Browse in the Sidebar

1. Expand an organization to see its Projects
2. Each Project contains:
   • Boards: work items in each sprint
   • Repos: Git repositories
3. Each Repository contains:
   • Branches: branch list
   • Pull Requests: PR list with filter
   • Pipelines: pipeline run history with filter
4. Right-click any node to perform actions

View Work Items

1. Expand Sprints and select a sprint
2. Work items are displayed in a parent-child hierarchy
3. Each work item label is shown as [Type] #ID Title (for example, [Epic] [#123](https://github.com/taizod1024/vscode-ado-extension/issues/123) Login)
4. Right-click the filter icon to change the view:
   • all: show everything
   • assigned: items assigned to you
   • myactivity: items you created or edited
   • active: incomplete items
5. Click the refresh icon on the sprint to reload

Create Work Items

• Open the Azure DevOps web UI from the Sprints page (Open Sprints icon) to create Epic / Issue / Task.

View Pull Requests

1. Expand Pull Requests under a repository
2. Right-click the filter icon to change the view:
   • mine: PRs you created
   • active: open PRs
   • completed: merged PRs
   • abandoned: abandoned PRs
3. Click the refresh icon on the PR list to reload

View Pipeline Runs

1. Expand Pipelines under a repository
2. The view loads runs from pipeline definitions linked to that repository
3. If repository linkage cannot be resolved, a same-name pipeline is used as fallback
4. The list shows up to the latest 50 runs
5. If 50 runs are shown, an "over 50 (showing latest 50)" info row is displayed at the end
6. Right-click the filter icon to change the view:
   • all: show all runs
   • running: in-progress runs
   • failed: failed / partially succeeded runs
   • succeeded: successful runs
7. Click the refresh icon on the pipeline list to reload

Repository Operations

1. Expand Repositories to view repos
2. Repositories are listed in ascending order by repository name
3. Click the icon buttons next to the repo to:
   • Open URL: open the Web UI in the integrated browser
   • Clone Repository: clone locally (PAT is embedded automatically)
   • Open Git Graph: open Git Graph for the locally cloned repository
4. Expand Branches to view the branch list
5. Click the refresh icon on Branches to reload
6. Click the $(git-pull-request) icon on a branch to open the PR creation page with the source branch pre-filled

Refresh the Tree

• Click the refresh icon next to the organization node.

Work Item Assignment

• Right-click a work item and select Assign to me to assign it to yourself
• Right-click a work item and select Unassign to remove the assignee

Link Work Items in Commit Messages

1. Open the Source Control panel and start typing a commit message
2. Type AB# or ab# to trigger the work item picker
3. Select a work item — the ID and title are inserted in AB#id:title format

Commands

Troubleshooting

Check Logs

1. Open View > Output
2. Select "Azure DevOps Extension" from the dropdown
3. Review API call and error logs

PAT Error

• Error: "Authentication failed. The PAT is invalid or has expired."
• Fix: Right-click the organization node and select "Enter PAT for Org" to re-enter the PAT
• The output log shows a masked value of the current PAT (first 4 chars only), removes the old PAT, then validates the new PAT

Repositories Not Shown

• Fetching sprint data may take a moment
• Run "Refresh Node" to reload

Security

• PAT is encrypted and stored in VS Code Secret Storage
• PAT is never written to logs (only the hostname is logged)
• When cloning, the PAT is passed to git and is not stored locally

Detailed Specification

See .github/APP_SPEC.md for the full specification.

Azure DevOps Extension JP

注意 この拡張機能は開発中です。

VS Code から Azure DevOps を操作する拡張機能です。

主要機能

• サイドバーで組織・プロジェクト・スプリント・ワークアイテム・リポジトリを参照
• ワークアイテムを親子階層（Epic → Feature → Story → Task）でフィルタ付きで表示
• PAT 自動埋め込みでリポジトリをクローン
• リポジトリごとのブランチ・PR をフィルタ付きで表示
• リポジトリごとのパイプライン実行履歴をフィルタ付きで表示（All / Running / Failed / Succeeded）
• ブランチからソースブランチ自動入力で PR 作成ページを開く
• ワークアイテムを GitHub Copilot Chat に送信
• ツリービューからワークアイテムに対応するブランチを自動作成
• ツリービューからワークアイテムを自分にアサイン・アサイン解除
• git コミットメッセージ入力欄で AB# または ab# と入力して Azure Boards のワークアイテムを選択
• PAT は VS Code の Secret Storage に安全に保存

インストール

1. VS Code の Extensions を開く（Ctrl+Shift+X）
2. "Azure DevOps Extension" を検索して Install

セットアップ

ステップ 1: PAT を取得

1. dev.azure.com にアクセス
2. User settings > Personal access tokens > New Token
3. 以下のスコープを選択:
   • Project and Team (Read)
   • Work Items (Read&Write)
   • Code (Read)
   • Build (Read)
4. トークンをコピー

ステップ 2: 組織を追加

1. VS Code のサイドバーで Azure DevOps Extension のアイコンをクリック
2. パネル上部の + アイコンをクリック
3. 組織名と PAT を入力

使い方

サイドバーで参照

1. Organizations を展開すると、Projects が表示される
2. 各 Project の下に以下が表示される:
   • Boards: スプリント内のワークアイテム
   • Repos: Git リポジトリ
3. 各 Repository の下に以下が表示される:
   • Branches: ブランチ一覧
   • Pull Requests: PR 一覧（フィルタ付き）
   • Pipelines: パイプライン実行履歴（フィルタ付き）
4. 各ノードを右クリックしてアクション実行

ワークアイテム参照

1. Sprints を展開して目的のスプリントを選択
2. ワークアイテムが親子階層で表示される
3. 各ワークアイテムは [種別] #ID タイトル 形式で表示される（例: [Epic] [#123](https://github.com/taizod1024/vscode-ado-extension/issues/123) Login）
4. フィルタアイコンを右クリックして表示内容を変更:
   • all: すべて表示
   • assigned: 自分に割り当てられたアイテム
   • myactivity: 自分が作成・編集したアイテム
   • active: 完了していないアイテム
5. スプリントのリフレッシュアイコンをクリックして再表示

ワークアイテム作成

• Sprints ページ（Open Sprints アイコン）から Azure DevOps の Web UI を開いて Epic / Issue / Task を作成

Pull Request 参照

1. Repository の下の Pull Requests を展開
2. フィルタアイコンを右クリックして表示内容を変更:
   • mine: 自分が作成した PR
   • active: オープンしている PR
   • completed: マージ済み PR
   • abandoned: 破棄された PR
3. PRのリフレッシュアイコンをクリックして再表示

パイプライン実行履歴参照

1. Repository の下の Pipelines を展開
2. 対象リポジトリに紐づくパイプライン定義の実行履歴を表示
3. リポジトリ紐づけが解決できない場合のみ、同名パイプライン定義をフォールバックとして使用
4. 実行履歴は新しい順で最大 50 件を表示
5. 50 件に達した場合は末尾に「over 50 (showing latest 50)」案内行を表示
6. フィルタアイコンを右クリックして表示内容を変更:
   • all: すべての実行を表示
   • running: 実行中
   • failed: 失敗・部分成功
   • succeeded: 成功
7. リフレッシュアイコンをクリックして再表示

リポジトリ操作

1. Repositories を展開してリポジトリを表示
2. リポジトリ名の昇順で表示される
3. リポジトリ横のアイコンをクリックして以下を実行:
   • Open URL: Web UI をブラウザで開く
   • Clone Repository: ローカルにクローン（PAT 自動埋め込み）
   • Open Git Graph: ローカルにクローン済みのリポジトリの Git Graph を開く
4. Branches を展開してブランチ一覧を表示
5. Branches のリフレッシュアイコンをクリックして再表示
6. ブランチの $(git-pull-request) アイコンをクリックするとソースブランチが自動入力された PR 作成ページを開く

ツリーをリフレッシュ

• 組織ノード横のリフレッシュアイコンをクリックする

ワークアイテムのアサイン

• ワークアイテムを右クリックして Assign to me を選択すると、自分にアサインされる
• ワークアイテムを右クリックして Unassign を選択すると、担当者が解除される

コミットメッセージでワークアイテムを参照

1. ソース管理パネルを開いてコミットメッセージの入力を開始
2. AB# または ab# と入力すると Work Item 候補が表示される
3. 候補を選択すると AB#id:title 形式で挿入される

コマンド一覧

トラブルシューティング

ログ確認

1. View > Output を開く
2. ドロップダウンから "Azure DevOps Extension" を選択
3. API 呼び出しやエラーのログを確認

PAT エラー

• エラーメッセージ: "Authentication failed. The PAT is invalid or has expired."
• 対応: 組織ノードを右クリックして「Enter PAT for Org」を選択して PAT を再設定
• 実行時は、現行 PAT の先頭 4 文字のみを残したマスク値をログに出力し、旧 PAT を削除してから新 PAT で接続確認する

リポジトリが表示されない

• スプリント情報の取得に時間がかかる場合がある
• 「Refresh Node」を実行して再読み込み

セキュリティ

• PAT は VS Code の Secret Storage に暗号化して保存
• ログには PAT は出力されない（ホスト名のみ）
• リポジトリクローン時、PAT は git に引き渡されローカルに保存されない

詳細仕様

詳しい仕様については .github/APP_SPEC.md を参照

謝辞

Azure devops logo Icon by CoreUI on Icon-Icons.com