Azure Repos
Connect Clearly AI to Azure DevOps repositories.
Connect Azure Repos so Clearly AI can use Azure DevOps repositories and branches as Project sources.
Azure Repos is separate from Azure DevOps Work Items. Use this page for code repositories. Use the Work Items page for tickets.
Create the PAT from an Azure DevOps user or service account that can access the repositories Clearly AI should read. Grant Code: Read for repository sources, or Code: Read & Write if Workflows should write pull request comments.
Create an Azure DevOps PAT
- In Azure DevOps, open User settings > Personal access tokens.
- Click New Token.
- Choose the organization Clearly AI should access.
- Set an expiration date that matches your security policy.
- Grant Code: Read for source ingestion, or Code: Read & Write if Clearly AI should write pull request comments.
- Create the token and copy it. Azure DevOps shows it only once.
Connect Azure Repos in Clearly AI
- In Clearly AI, open Integrations and select Azure DevOps Repository.
- In Organization ID, enter the Azure DevOps organization name from
https://dev.azure.com/<organization>. - In Personal Key, paste the PAT.
- Save and test the connection.
The connection test verifies the organization and basic repository access.
Add an Azure Repos branch as a source
- Open a Project.
- Open Manage Sources and click Search Integrations.
- Select Azure DevOps Repository.
- Choose the Azure DevOps project.
- Choose the repository.
- Choose the branch. Clearly AI prefers the API-reported default branch when available.
- Save the source and wait for processing.
Clearly AI downloads the selected branch, filters common junk files, and stores the result as Project context for Reviews and Chat.
Narrow large repositories
Repository sources can be large. When needed, use file include and exclude patterns in the source configuration.
Examples:
files_to_include: ["src/**", "infra/**"]
files_to_exclude: ["node_modules", "*.log", "*.test.*", ".*"]