ado-sync — VS Code Extension

Bidirectional sync between local test specs (.feature, .md) and Azure DevOps Test Cases, right from VS Code.

Requirements

ado-sync installed globally or locally in your project:

npm install -g ado-sync
# or per-project
npm install --save-dev ado-sync

An ado-sync.json config file in your workspace root (setup guide)

Features

Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`)

Command	Description
`ado-sync: Push`	Push local spec changes to Azure DevOps
`ado-sync: Push (Dry Run)`	Preview what would be pushed
`ado-sync: Pull`	Pull ADO changes into local spec files
`ado-sync: Pull (Dry Run)`	Preview what would be pulled
`ado-sync: Status`	Show diff between local and ADO
`ado-sync: Validate Config`	Check config validity and Azure connection
`ado-sync: Generate Spec from Story`	Generate `.feature` or `.md` from an ADO User Story ID
`ado-sync: Fetch Test Case`	Fetch a specific ADO Test Case by ID and display its details
`ado-sync: Publish Test Results`	Upload local test result files (Playwright, Cucumber, JUnit, TRX, NUnit, CTRF) to an ADO Test Run

CodeLens

Every @tc:12345 tag in a .feature or .md file gets inline links:

  @tc:1234
  Scenario: Login with valid credentials   ← $(link-external) View TC [#1234](https://github.com/PavanMudigonda/ado-sync-vscode/issues/1234) in ADO | $(cloud-download) Fetch TC [#1234](https://github.com/PavanMudigonda/ado-sync-vscode/issues/1234) | $(cloud-upload) Push

Hover

Hover over any @tc: tag to see a tooltip with a direct link to Azure DevOps.

The Testing panel includes an ADO Test Cases tree that lists all spec files containing @tc: tags, expandable to show each linked test case with its line number.

Status Bar

A status bar item shows the current sync state. Click it to run ado-sync status.

Extension Settings

Setting	Default	Description
`ado-sync.configPath`	`""`	Path to config file (relative to workspace root). Leave empty to auto-detect.
`ado-sync.showCodeLens`	`true`	Show CodeLens links above `@tc:` tags
`ado-sync.autoStatus`	`false`	Run status check automatically when a spec file is saved
`ado-sync.outputLevel`	`"normal"`	Output verbosity: `normal`, `verbose`, or `quiet`

Quick Start

Install ado-sync globally: npm install -g ado-sync
In your project root, run: ado-sync init — creates ado-sync.json
Install this extension
Open a .feature or .md spec file — @tc: CodeLens links appear immediately
Open Command Palette → ado-sync: Validate Config to confirm connectivity

Output

All command output streams to the ado-sync Output Channel (View → Output → select ado-sync).

License

MIT

ado-sync

PavanMudigonda