AZD: Settings reference

Accounts

Path: Settings | Version Control | AZD

Accounts list

Your Azure DevOps accounts. Click + to add one with Sign in with Personal Access Token, Sign in with Microsoft or Sign in with Azure CLI, and − to remove one. See Connect to Azure DevOps.

For the permissions requested by Microsoft sign-in, see Sign in with Microsoft.

Clone git repositories using ssh

Clones over SSH. When cleared, AZD clones over HTTPS. Default: on. See Choose SSH or HTTPS.

Preferences

Path: Settings | Version Control | AZD | Preferences. For AI providers and prompts, see AI Settings.

Automatically mark opened files as viewed

Marks a pull request file as viewed when you open its diff. Default: off.

Auto-fill description from PR templates

Fills the description of a new pull request from the repository's pull request template. Default: off.

Auto-refresh pipelines, Interval in seconds

Refreshes the pipeline run list and open runs at the set interval (5–1800 seconds). Default: off, 60 seconds.

Auto-refresh pull requests, Interval in seconds

Refreshes the pull request list and open pull requests at the set interval (5–1800 seconds). Default: off, 60 seconds.

Open AZD links in tool window

Opens links between AZD views inside the AZD tool windows instead of the browser: pipeline links in pull requests, pull request links in pipeline runs and work items, and runs opened from agent pools. Default: on.

Open commit links from the timeline in the IDE

Opens a commit link in the pull request timeline in the pull request details, with the commit selected, instead of on Azure DevOps. Default: on.

Respect proxy configuration

Uses the proxy configured in the IDE for AZD connections. Default: off.

Accept untrusted SSL certificates

Skips certificate validation for AZD connections only, for networks with a TLS-inspecting proxy. Other IDE connections are not affected. Default: off.

Use API-based diff generation (experimental)

Builds pull request diffs from the Azure DevOps API instead of Git. Faster, but binary files may not show correctly. Default: off.

Azure CLI (az) path (optional)

The az executable for Azure CLI sign-in. Leave empty to detect it automatically, or click Detect.

Filter subject type

Identity types for user searches. In the current version this field has no effect; AZD always searches msa,aad,win,imp,vss.

Share anonymous usage statistics

Sends an anonymous event when a Microsoft sign-in starts, succeeds or fails. Default: on. See Privacy and usage statistics.

AI Settings

Path: Settings | Version Control | AZD | AI Settings. AI features work without setup: the built-in AZD provider is configured and set as the default.

Enable AI assistance

Turns all AZD AI features on or off. Default: on. See AZD: AI assistant.

Enable MCP Tools

Lets AI chat create work items, manage pull requests and trigger pipelines. Default: off. See MCP tools.

Show illustrations in AI review tour

Shows a cover image on the first card of the AI review tour. Default: off. See AI review tour.

AI Providers

The providers and models AZD can use. See AI providers.

Configure Prompts

The prompts for titles, descriptions, commit messages and reviews, and whether each feature is enabled. See Configure prompts.

For how the default provider handles your data, see AI and privacy.

UI Customization

Path: Settings | Version Control | AZD | UI Customization

Adopt Azure DevOps UI style

Makes the pull request details look more like the Azure DevOps web UI, with a Submit Review button for votes. Default: off.

Show events in the order ascending by date

Shows the oldest timeline events first. Clear it to show the newest first. Default: on.

Boards and Work Items

Path: Settings | Version Control | AZD | Boards and Work Items

The first options control which work items you can pick when you link work items to a pull request or a commit.

Show Work items from all Projects

Lists work items from every project in the organization or collection, not only the project of the repository. Default: off.

Limit work items to recent history

Lists only work items changed within the set number of days (0–60). Default: on, 60 days.

Enable work item commit message action

Adds Select Work Item... to the AZD commit message button. Default: on. See Add work items to a commit message.

Template

The commit message template. Placeholders: {id}, {title}, {type}, {state}. To insert one at the caret, click + in the field. Default: {id} - {title}.

Max work items per commit

How many work items you can select for one commit message (1–10). Default: 5.

Advanced, Custom Work Item Query

The WHERE clause of the query that lists work items for linking to pull requests and commits. By default it hides work items in the Done, Closed and Removed states. The Select Work Item for Commit Message dialog also applies its own state filter; see Add work items to a commit message. Select Use custom WHERE clause to edit it; the text must start with WHERE.

Pipeline Settings

Path: Settings | Version Control | AZD | Pipeline Settings

Inject Azure DevOps YAML pipeline schema

Turns on completion and validation in pipeline files through the Azure Pipelines language server. Default: on. See AZD: Edit Azure Pipelines YAML.

Additional pipeline YAML locations

More folders or glob patterns, relative to the project root and separated by semicolons, whose YAML files count as pipeline files. Project setting. See Which files are pipeline files.

Approval Notifications

Pipelines whose approvals do not raise a notification. Changes apply immediately. Project setting. See Mute approval notifications.

Node.js Configuration

The Node.js executable for the language server, and Validate Node.js. Leave the path empty to detect Node.js automatically.

Pull request filters

Custom quick filters for the pull request list are managed in the AZD Pull Requests tool window, not in Settings. See Custom quick filters.

Notifications

AZD notification groups are listed in Settings | Appearance & Behavior | Notifications: AZD notifications, Azure DevOps AI, Azure DevOps AI Suggestions, AZD agents and AZD Pipeline Approvals.