User settings > Personal access tokens > New Token
Select the following scopes:
Project and Team (Read)
Work Items (Read&Write)
Code (Read)
Build (Read)
Copy the token
Step 2: Add an Organization
Click the Azure DevOps Extension icon in the VS Code sidebar
Click the + icon at the top of the panel
Enter your organization name and PAT
Usage
Browse in the Sidebar
Expand an organization to see its Projects
Each Project contains:
Boards: work items in each sprint
Repos: Git repositories
Each Repository contains:
Branches: branch list
Pull Requests: PR list with filter
Pipelines: pipeline run history with filter
Right-click any node to perform actions
View Work Items
Expand Sprints and select a sprint
Work items are displayed in a parent-child hierarchy
Each work item label is shown as [Type] #ID Title (for example, [Epic] [#123](https://github.com/taizod1024/vscode-ado-extension/issues/123) Login)
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
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
Expand Pull Requests under a repository
Right-click the filter icon to change the view:
mine: PRs you created
active: open PRs
completed: merged PRs
abandoned: abandoned PRs
Click the refresh icon on the PR list to reload
View Pipeline Runs
Expand Pipelines under a repository
The view loads runs from pipeline definitions linked to that repository
If repository linkage cannot be resolved, a same-name pipeline is used as fallback
The list shows up to the latest 50 runs
If 50 runs are shown, an "over 50 (showing latest 50)" info row is displayed at the end
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
Click the refresh icon on the pipeline list to reload
Repository Operations
Expand Repositories to view repos
Repositories are listed in ascending order by repository name
Click the icon buttons next to the repo to:
Open URL: open the Web UI in the integrated browser
Open URL (External): open the Web UI in the default browser
Clone Repository: clone locally using the Git credential manager
Open Git Graph: open Git Graph for the locally cloned repository
Expand Branches to view the branch list
Click the refresh icon on Branches to reload
Click the $(git-pull-request) icon on a branch to open the PR creation page with the source branch pre-filled
Clone Azure Repos from Git: Clone
Open the Source Control view and select Clone Repository
Select Azure Repos from the remote source list
Search for a project or repository, then select a repository to clone
The Azure Repos source uses the Azure DevOps icon and lists repositories from configured organizations for which a PAT is stored. Authentication for the clone itself is handled by Git Credential Manager; credentials are not included in the clone URL.
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
Open the Source Control panel and start typing a commit message
Type AB# or ab# to trigger the work item picker
Select a work item — the ID and title are inserted in AB#id:title format
Commands
Command
Description
Add Organization
Add an organization
Enter PAT for Org
Re-enter PAT for a specific org
Remove Organization
Remove an organization
Remove All Organizations
Remove all organizations
Open Sprints
Open the sprints page in the browser
Create Pull Request
Open PR creation page with source branch
Clone Repository
Clone a repository
Open Git Graph
Open Git Graph for the repository
Refresh Node
Refresh the tree
Refresh Branches
Refresh the branch list
Refresh PR Items
Refresh pull request list (keep filter)
Refresh Pipelines
Refresh pipeline run list (keep filter)
Open Work Items
Open the work items list
Open URL
Open in the integrated browser
Open URL (External)
Open in the default browser
Send Work Item to Copilot
Send a work item to GitHub Copilot
Create Branch for Work Item
Create/checkout a branch for a work item
Assign to me
Assign a work item to yourself
Unassign
Remove the assignee from a work item
Open Settings
Open extension settings
Troubleshooting
Check Logs
Open View > Output
Select "Azure DevOps Extension" from the dropdown
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)
The Azure Repos source for VS Code's Git: Clone does not include PATs in clone URLs; Git Credential Manager handles authentication
