# ADO Pilot > AI-powered pull request review for Azure DevOps. Install the marketplace extension and every pull request is automatically reviewed — no pipeline changes required. Usage-based pricing, billed via Stripe. ## Product - [Features](https://adopilot.dev/features): What ADO Pilot reviews and how it integrates with Azure DevOps. - [How It Works](https://adopilot.dev/how-it-works): The setup flow: install the extension, authorize, and reviews start automatically. - [Pricing](https://adopilot.dev/pricing): Usage-based plans and the trial. - [Getting Started](https://adopilot.dev/getting-started): Step-by-step installation walkthrough. ## Getting Started - [What is ADO Pilot?](https://adopilot.dev/docs/getting-started/what-is-ado-pilot): AI-powered pull request reviews for Azure DevOps. What it reviews, where comments appear, and the BYOL billing model. - [System requirements](https://adopilot.dev/docs/getting-started/system-requirements): Azure DevOps Services only, HTTPS, supported browsers, and Stripe billing prerequisites for ADO Pilot. - [Pricing overview](https://adopilot.dev/docs/getting-started/pricing-overview): How review credits are calculated, the four plan tiers, hard-block vs auto-overage, the annual discount, and the trial. - [Quickstart](https://adopilot.dev/docs/getting-started/quickstart): Sign up, connect Azure DevOps with a personal access token, and watch ADO Pilot review a real pull request — about ten minutes end to end. - [Installing the Marketplace extension](https://adopilot.dev/docs/getting-started/installing-the-extension): Optional Azure DevOps Marketplace extension adding a Run AI Review button and an in-ADO settings hub; reviews run with or without it via service hooks. ## Connecting Azure DevOps - [Choosing an auth method](https://adopilot.dev/docs/connecting-ado/auth-methods): Compare PAT and Service Principal authentication for connecting ADO Pilot to your Azure DevOps organization. - [Creating a Personal Access Token](https://adopilot.dev/docs/connecting-ado/creating-a-pat): Step-by-step guide to create an Azure DevOps personal access token with the scopes ADO Pilot needs. - [Setting up Service Principal auth](https://adopilot.dev/docs/connecting-ado/service-principal-setup): Grant admin consent and add the ADO Pilot service principal so reviews run with no stored credential — covering the consent page and already-consented path. - [Rotating or replacing your PAT](https://adopilot.dev/docs/connecting-ado/rotating-your-pat): How to swap an Azure DevOps personal access token for ADO Pilot on a routine schedule or in response to a compromise. - [Service hooks and webhooks](https://adopilot.dev/docs/connecting-ado/service-hooks-explained): What ADO Pilot installs in your Azure DevOps organization, where to find it, and how the webhook authentication model works. ## Marketplace Extension - [Installing and sharing the extension](https://adopilot.dev/docs/extension/installing): Install the optional ADO Pilot Marketplace extension to add a PR action button and a settings hub any organization member can open. Reviews run without it. - [Using the PR action menu](https://adopilot.dev/docs/extension/pr-action-menu): The ADO Pilot Run AI Review entry opens a confirm dialog that starts an on-demand review of the current pull request. Automatic reviews run on every update. - [The ADO Pilot settings hub](https://adopilot.dev/docs/extension/settings-hub): Any organization member can view ADO Pilot subscription status, an aggregate connection-health summary, and trigger on-demand reviews from the settings hub. - [Uninstalling the extension](https://adopilot.dev/docs/extension/uninstalling): Uninstalling removes the ADO Pilot UI and pauses AI reviews. Reinstalling brings reviews back; cancel from the dashboard to stop reviews and billing for good. ## Reviews - [Anatomy of a review comment](https://adopilot.dev/docs/reviews/anatomy-of-a-review-comment): How to read the ADO Pilot tracking comment and inline findings on your pull request, from queued to complete. - [Severities and categories](https://adopilot.dev/docs/reviews/severities-and-categories): What ADO Pilot's severities and categories mean, and how findings roll up to a PASS, ADVISORY, or FAIL verdict. - [Why some findings are dropped before they reach your PR](https://adopilot.dev/docs/reviews/two-pass-design): ADO Pilot reviews in two passes — a high-recall sweep, then a critical re-check that drops 30–50% of candidate findings before they reach your PR, by design. - [What is not reviewed](https://adopilot.dev/docs/reviews/whats-not-reviewed): The boundary cases ADO Pilot skips — binaries, excluded files, target-branch filters, closed PRs, and suspended tenants. - [Re-running a review](https://adopilot.dev/docs/reviews/re-running-a-review): How to trigger a fresh ADO Pilot review — automatic on push, the PR action menu, the Settings Hub, or the dashboard. - [Mid-review pushes](https://adopilot.dev/docs/reviews/mid-review-pushes): What happens when you push a new commit mid-review — reviews queue per-PR, and ADO Pilot reviews the latest iteration when several are waiting. - [How long does a review take?](https://adopilot.dev/docs/reviews/review-duration): Most ADO Pilot reviews complete in 2 to 5 minutes; large pull requests or high AI-provider load can extend that. What affects duration and what to expect. ## Configuring - [Org, project, and repo settings hierarchy](https://adopilot.dev/docs/configuring/settings-hierarchy): How ADO Pilot resolves configuration across organization, project, and repository scopes — override semantics for scalars, additive merging for arrays. - [Choosing which repositories get reviewed](https://adopilot.dev/docs/configuring/enabling-repositories): Pick which Azure DevOps repositories ADO Pilot reviews from the dashboard, and see how repository enablement fits the settings hierarchy. - [Targeting branches](https://adopilot.dev/docs/configuring/branch-filters): Use glob patterns to control which branches trigger ADO Pilot reviews. Examples for trunk-based and GitFlow workflows. - [Excluding files from review](https://adopilot.dev/docs/configuring/file-exclusions): Skip generated code, build artifacts, and vendored dependencies with file exclusion patterns. Excluded lines do not consume review credits. - [Manual vs automatic reviews](https://adopilot.dev/docs/configuring/manual-vs-automatic): Control when ADO Pilot reviews — reviewOnPush gates push-triggered reviews, or trigger on demand from the PR action menu or Settings Hub. - [Setting AI review as a required PR check](https://adopilot.dev/docs/configuring/required-status-check): Configure the ADO Pilot status check as a required Azure DevOps branch policy so PRs cannot merge until the AI review completes. ## Billing - [Review credits explained](https://adopilot.dev/docs/billing/review-credits-explained): How ADO Pilot converts a pull request diff into review credits, and what code is excluded from the count. - [Plan tiers](https://adopilot.dev/docs/billing/plan-tiers): Compare Starter, Team, Business, and Enterprise plans, and find the tier that matches your team's review volume. - [Overage behavior](https://adopilot.dev/docs/billing/overage-behavior): How ADO Pilot handles reviews after you exhaust your included RCs, including hard-block, auto-overage, and the overage cap. - [Billing periods](https://adopilot.dev/docs/billing/billing-periods): How ADO Pilot's monthly billing period works, when RCs reset, and how annual plans differ. - [Changing your plan](https://adopilot.dev/docs/billing/changing-your-plan): What happens when you upgrade, downgrade, or cancel your ADO Pilot subscription, and when each change takes effect. - [Invoices and payment](https://adopilot.dev/docs/billing/invoices-and-payment): How to view invoices, update your payment method inline, and resolve failed payments. - [Trial and conversion](https://adopilot.dev/docs/billing/trial-and-conversion): How the ADO Pilot free trial works and how to convert your trial into a paid subscription without losing your configuration. ## Team - [Roles and permissions](https://adopilot.dev/docs/team/roles-and-permissions): What Admin, Member, and Viewer roles can do in ADO Pilot, and the exact errors you see when a non-admin tries an admin-only action. - [Inviting team members](https://adopilot.dev/docs/team/inviting-members): How to invite team members (Admin, Member, or Viewer) to your ADO Pilot org, when invites expire, and how to handle duplicates. - [Removing team members](https://adopilot.dev/docs/team/removing-members): How to remove a member from your ADO Pilot org, the 24-hour stale-session window, and why you cannot remove yourself. ## Notifications - [Email notifications](https://adopilot.dev/docs/notifications/email-notifications): Configure which transactional emails ADO Pilot sends — review completion, credit alerts, plan changes, and the weekly digest. - [Outgoing webhooks](https://adopilot.dev/docs/notifications/outgoing-webhooks): Send ADO Pilot review and billing events to your own HTTPS endpoint — configure the URL, choose events, and validate delivery with a test send. ## Troubleshooting - [My PR didn't get an AI review — quota exhausted](https://adopilot.dev/docs/troubleshooting/quota-exceeded): Why a PR is silent after ADO Pilot's review credits are exhausted on a capped or hard-blocked org, and how to get reviews running again. - [Connection status or expiry shows Unknown](https://adopilot.dev/docs/troubleshooting/integration-status-unknown): Why the Integration page sometimes shows 'Unknown' for connection status or PAT expiry, and how to resolve it. - [Webhook 401s and reviews stopped firing](https://adopilot.dev/docs/troubleshooting/webhook-401): What to do when ADO Pilot stops reviewing new PRs because the webhook subscription is returning 401 Unauthorized. - [PAT and onboarding wizard error codes](https://adopilot.dev/docs/troubleshooting/pat-scope-errors): Reference for every error code the onboarding wizard can return when validating your PAT or first PR URL, with the fix for each. - [Reviews stuck in 'in progress'](https://adopilot.dev/docs/troubleshooting/stuck-review): What to do when a review's summary comment shows 'in progress' for longer than the typical review window. - [No findings posted on a large PR](https://adopilot.dev/docs/troubleshooting/large-pr-no-findings): Why ADO Pilot may return an empty or failed review on a large PR, and how to get better coverage. - [Frequently asked questions](https://adopilot.dev/docs/troubleshooting/faq): Quick answers to the most-asked questions about ADO Pilot — credits, comments, quota, scopes, data handling, and more. - [Reviews never started: service-hook permission error](https://adopilot.dev/docs/troubleshooting/service-hook-permissions): Fix the case where ADO Pilot connects successfully but can't create the service-hook subscriptions pull request reviews depend on. ## Trust & Security - [Data handling](https://adopilot.dev/docs/trust/data-handling): What ADO Pilot sends to Anthropic for each review, what stays out, how long content lives, and where the legal basis is documented. - [Tenant isolation](https://adopilot.dev/docs/trust/tenant-isolation): How ADO Pilot keeps each customer organization's data, credentials, and webhook traffic separated from every other tenant. - [Legal documents](https://adopilot.dev/docs/trust/legal): Where to find ADO Pilot's privacy policy, terms of service, subprocessor list, and how to request a Data Processing Addendum. - [Support and contact](https://adopilot.dev/docs/trust/support-and-contact): How to reach ADO Pilot support — the public /support form for prospects and in-portal Support page for customers — and which email aliases handle each lane. - [Account sign-in and security](https://adopilot.dev/docs/trust/account-security): How to sign in to ADO Pilot, enroll multi-factor authentication, manage trusted devices, and what step-up re-authentication means for sensitive actions. ## Reference - [Glossary](https://adopilot.dev/docs/reference/glossary): Definitions for every ADO Pilot term you'll encounter across the documentation, billing, and integration surface. - [Status check reference](https://adopilot.dev/docs/reference/status-check-reference): Lifecycle, states, and branch-policy wiring for the adopilot/ai-pr-review status check. - [Admin API](https://adopilot.dev/docs/reference/admin-api): ADO Pilot has no public admin API in v1. This page outlines the deferred public API roadmap for v2. - [Changelog](https://adopilot.dev/docs/reference/changelog): Version history for the ADO Pilot Azure DevOps Marketplace extension and backend. ## Optional - [Privacy Policy](https://adopilot.dev/privacy) - [Terms of Service](https://adopilot.dev/terms) - [Subprocessors](https://adopilot.dev/subprocessors)