> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agile-tools.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Source Code Management

> Overview of SCM integrations in Agile Tools

# Source Code Management Integrations

Agile Tools integrates with popular Git hosting providers to connect your development workflow with OKRs and work management.

## Supported Providers

> **[GitHub](https://docs.agile-tools.io/en/admin/integrations/github.md)**
>
> GitHub.com and GitHub Enterprise

> **[GitLab](https://docs.agile-tools.io/en/admin/integrations/gitlab.md)**
>
> GitLab.com and self-managed GitLab

> **[Bitbucket](https://docs.agile-tools.io/en/admin/integrations/bitbucket.md)**
>
> Bitbucket Cloud and Bitbucket Server

## What Can You Do With SCM Integrations?

| Feature | Description |
| - | - |
| **Link commits to work items** | Reference Value Items in commit messages |
| **Track development progress** | See commit activity on Key Results |
| **Automate status updates** | Move work items based on branch/PR status |
| **Sync repositories** | Import repos as Value Units or link to existing ones |

## Integration Architecture

```
┌─────────────────┐      Webhooks      ┌─────────────────┐
│  Git Provider   │ ─────────────────▶ │   Agile Tools   │
│ (GitHub/GitLab) │                    │                 │
└─────────────────┘      API Calls     └─────────────────┘
                   ◀───────────────────
```

Agile Tools uses **OAuth** for authentication and **webhooks** for real-time updates.

## Prerequisites

Before connecting:

1. You need **Administrator** access in Agile Tools
2. You need **Admin** or **Owner** permissions in your Git provider
3. For self-hosted instances, ensure network connectivity to Agile Tools

## Getting Started

Choose your provider and follow the setup guide:

* [GitHub Integration](https://docs.agile-tools.io/en/admin/integrations/github.md)
* [GitLab Integration](https://docs.agile-tools.io/en/admin/integrations/gitlab.md)
* [Bitbucket Integration](https://docs.agile-tools.io/en/admin/integrations/bitbucket.md)

> [!NOTE]
>
> **Are you a Developer?** Once the connection is established by an
> Administrator, see our [Git Sync
> Automation](https://docs.agile-tools.io/en/developer/integrations/git-sync.md) guide to automate workflows
> and customize field mappings.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.