Installing the Marketplace extension

The ADO Pilot Marketplace extension is optional and is not part of onboarding. Reviews start running as soon as you finish the Quickstart — the onboarding wizard provisions service-hook subscriptions directly against your Azure DevOps organization, and those subscriptions are what triggers reviews. Install the extension only when you want a Run AI Review button in the PR action menu and a read-only ADO Pilot settings hub inside Azure DevOps.

What the extension adds

• Run AI Review button on the pull-request action menu. Triggers an immediate review without waiting for a push.
• ADO Pilot hub under your project's admin pages. Read-only view of connection and review status; full configuration still lives at adopilot.dev.
• ADO Pilot appears as a service-hook consumer when an admin browses your organization's service hooks. Subscriptions managed from the consumer page redirect to adopilot.dev.

What the extension doesn't change

• Backend reviews run identically whether the extension is installed or not.
• All configuration — repository selection, branch filters, exclusion patterns, plan and billing — stays at adopilot.dev. The in-ADO hub is read-only.
• Uninstalling the extension does not stop reviews. The service hook subscriptions remain. To fully stop reviews, see Uninstalling the extension and cancel your subscription in the dashboard.

Required scopes

The extension requests three Azure DevOps scopes when an admin installs it:

• vso.code — read pull request diffs and post status checks.
• vso.threads_full — read and write pull request comment threads.
• vso.code_status — post the ai-pr-review status check (genre adopilot).

Azure DevOps treats scope changes as a re-consent event for every existing install. The v1 scope set above is intentionally minimal so future point releases don't force your administrators to re-consent.

Install the extension

You need organization-admin permission in the target Azure DevOps Services organization to install the extension.

Step 1 — Open the Marketplace listing

Search the Azure DevOps Marketplace for ADO Pilot, or follow the listing link from adopilot.dev.

Step 2 — Install into your organization

Click Get it free (the Marketplace label for paid BYOL extensions; you pay ADO Pilot directly), select your organization from the dropdown, and click Install. Azure DevOps prompts you to consent to the scopes listed above.

Step 3 — Confirm the install

After install, Azure DevOps redirects to a post-install page. The page records install telemetry and then closes — no input required from you.

To verify the install:

• Open any pull request in the organization. The Run AI Review entry appears on the action menu.
• Open Project settings for any project. ADO Pilot appears in the admin hub list and shows your connection and review status.

After installation

Service hook subscriptions installed by the onboarding wizard remain in place — the extension does not duplicate them. You don't need to reconfigure anything; the Run AI Review button uses the same backend pipeline as automatic reviews.

Uninstalling

To remove the extension:

1. Go to Organization settings > Extensions > Installed.
2. Find ADO Pilot and click Uninstall.

What stops:

• The Run AI Review PR action menu entry.
• The ADO Pilot project-admin hub.

What continues:

• Automatic reviews. The service hook subscriptions are independent of the extension.
• Billing. You still consume RCs against your plan.

To fully terminate the service, also remove the service hook subscriptions and cancel your subscription. See Uninstalling the extension for the complete shutdown procedure.