ADO Local Sync
Sync Azure DevOps (ADO) work items and wikis directly to your local workspace as Markdown files. Designed to seamlessly bridge Azure DevOps with local workflows, note-taking apps, and AI agents like GitHub Copilot.
Features
- Work Item Sync: Download ADO work items as local Markdown files, complete with descriptions, tags, and comments.
- Local Wiki Sync: Clone and pull Azure DevOps wikis to view and edit documentation locally.
- Agent & Copilot Friendly: Exposes dedicated silent commands for local AI agents to safely read and update work item tags.
- Secure Credentials: Keeps your Personal Access Tokens (PAT) safe using VS Code's native
SecretStorage.
- Zero Credential Exposure: Safely update tags and metadata without exposing API keys to scripts or AI contexts.
Quick Start
- Configure Connection:
Open the Command Palette (
Ctrl+Shift+P or Cmd+Shift+P) and run:
ADO Sync: Configure
Set your Organization, Project, Local Sync Folder, and optional target Wiki.
- Authenticate:
Run the following command and enter your Azure DevOps Personal Access Token (PAT):
ADO Sync: Set PAT
- Run Your First Sync:
Execute
ADO Sync: Sync Both to pull your work items and wiki pages.
Commands
| Command Title |
Command Identifier |
Description |
| ADO Sync: Configure |
adoLocalSync.configure |
Set up your Azure DevOps org, project, and sync paths. |
| ADO Sync: Set PAT |
adoLocalSync.setPat |
Securely store your Azure DevOps PAT in SecretStorage. |
| ADO Sync: Clear PAT |
adoLocalSync.clearPat |
Remove stored credentials from VS Code. |
| ADO Sync: Sync Work Items |
adoLocalSync.syncWorkItems |
Fetch and update local Markdown work items. |
| ADO Sync: Sync Wiki |
adoLocalSync.syncWiki |
Clone/pull the configured Azure DevOps wiki locally. |
| ADO Sync: Sync Both |
adoLocalSync.syncBoth |
Sync both work items and wikis in a single operation. |
| ADO Sync: Select Wikis |
adoLocalSync.selectWikis |
Browse and choose accessible wikis in your project. |
| ADO Sync: Add Tags To Work Items |
adoLocalSync.addTags |
Add tags to selected items with interactive prompts. |
Output Folder Structure
When synchronized, files are organized in your chosen sync folder:
<your-sync-folder>/
├── work-items/
│ ├── 749858-feature-title.md
│ └── ...
└── wiki/
├── Overview.md
└── ...
Extension Settings
This extension contributes the following settings through VS Code (File > Preferences > Settings or Cmd+,):
adoLocalSync.organization: Your Azure DevOps organization name.adoLocalSync.project: Your target Azure DevOps project name.adoLocalSync.localPath: The workspace path where items and wikis are saved.adoLocalSync.wikiName: (Optional) The specific wiki to target for local sync.
AI Agent Integration
ADO Local Sync exposes execution commands for AI assistants (like GitHub Copilot Chat or local script automation) without passing credentials through the LLM context.
Silent Tagging Command
Command: adoLocalSync.addTagsSilent
Payload Schema:
{
"ids": [749858],
"tags": ["AI Reviewed"],
"dryRun": true
}
Security & Privacy
- SecretStorage Integration: PATs are stored via VS Code's encrypted secret store and never saved in plain text files.
- Least Privilege: Recommended PAT scope requires only Work Items (Read & Write) and Code (Read & Write) for Wiki sync.
- Agent Safety: Secrets are never sent to or evaluated by local AI agents during silent command calls.
Contributing & Issues
Found a bug or have a feature request?
License
MIT
