ADO Local Sync
A VS Code extension that syncs Azure DevOps work items and wikis to your local machine.
Features
- Sync work items to Markdown files
- Sync Azure DevOps wikis locally
- Include descriptions, tags and comments
- Git-based wiki updates (clone/pull)
- Secure PAT storage in VS Code SecretStorage
- Add tags to work items without exposing credentials
- Agent-friendly commands for Copilot and other local agents
Requirements
- Visual Studio Code
- Node.js and npm
- Git
- Azure DevOps access
- Azure DevOps PAT (recommended)
Install
npm install
npm run compile
Run in Development
Open the project in VS Code and press F5.
Package as VSIX
npm install --save-dev @vscode/vsce
npm run compile
npx vsce package
Creates:
ado-local-sync-x.x.x.vsix
Install VSIX
code --install-extension ado-local-sync-x.x.x.vsix --force
Or use:
Extensions → Install from VSIX
Configuration
Run:
ADO Sync: Configure
Provide:
- Organisation
- Project
- Optional wiki
- Local sync folder
Save PAT:
ADO Sync: Set PAT
Clear PAT:
ADO Sync: Clear PAT
Common Commands
| Command |
Purpose |
| ADO Sync: Select Wikis |
Choose accessible wikis |
| ADO Sync: Sync Work Items |
Sync work items locally |
| ADO Sync: Sync Wiki |
Sync selected wikis |
| ADO Sync: Sync Both |
Sync work items and wikis |
| ADO Sync: Add Tags To Work Items |
Add tags to Azure DevOps items |
Output Structure
<folder>/
├── work-items/
└── wiki/
Agent API
Command:
adoLocalSync.addTagsSilent
Example:
{
"ids": [749858],
"tags": ["AI Reviewed"],
"dryRun": true
}
Security
- PATs are stored in VS Code SecretStorage
- PATs are never exposed to agents
- Do not commit PATs to source control
- Use least-privilege permissions
- Use dry-run before bulk updates
Publishing
Package:
npm run compile
npx vsce package
Publish:
npx vsce publish
Repository
