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

# GitHub

> Sync your GitHub roadmap into ClosedLoop AI: Projects boards, milestones, and issues connect to customer demand and the insights behind each feature.

Connect GitHub to ClosedLoop AI and your roadmap gains customer evidence. ClosedLoop AI syncs your organization's planning data as a roadmap source, then matches customer demand (insights and themes) onto the work you have planned, so the issues your team ships are grounded in what customers actually ask for.

## What Gets Synced

| Data            | Description                                                         |
| --------------- | ------------------------------------------------------------------- |
| Projects boards | Items on your GitHub Projects boards, including their status fields |
| Milestones      | Milestone groupings and their issues                                |
| Issues          | Individual issues, including sub-issues nested under larger work    |

<Note>GitHub is a **roadmap source**, not a feedback source. ClosedLoop AI syncs a full copy of your planning data each cycle, so the roadmap always reflects the current state in GitHub. There is no lookback window to configure, and roadmap sync does not consume AI analysis credits.</Note>

## Connection Method

GitHub connects through a **read-only GitHub App**. You install the ClosedLoop AI App on your organization; ClosedLoop AI reads planning data through it and never writes to your repositories.

## Setup Guide

<AccordionGroup>
  <Accordion icon="plug" title="Connect GitHub">
    1. In ClosedLoop AI, go to **Settings, Integrations**
    2. Find **GitHub** in the integrations list and click **Connect**
    3. You'll be taken to GitHub to install the ClosedLoop AI App on your organization
    4. Approve the read access and complete the installation
    5. You'll be redirected back to ClosedLoop AI. The integration is now active
  </Accordion>

  <Accordion icon="map" title="Primary roadmap">
    If you connect more than one roadmap tool, one of them acts as your team's primary product roadmap. The first roadmap tool you connect becomes the primary automatically; you can change which tool is primary in Settings at any time.
  </Accordion>
</AccordionGroup>

<Tip>ClosedLoop AI adapts to how your organization plans. If you use Projects boards, board items become your roadmap; if you plan with milestones or plain issues instead, the roadmap is built from those.</Tip>

## What You Get

Once connected, ClosedLoop AI will:

1. **Sync your boards, milestones, and issues** in full, keeping the roadmap current with GitHub
2. **Project them onto your roadmap** as initiatives and features, with sub-issues as tasks
3. **Match customer demand**: insights and themes connect to the features they support, so every roadmap item shows its evidence
4. **Reveal coverage gaps**: see which customer demand is not yet reflected in planned work

Changes you make in GitHub appear in ClosedLoop AI after the next sync cycle. The sync is read-only: the App reads your planning data and never writes back to GitHub.

<Card title="Connect GitHub" icon="plug" href="https://app.closedloop.sh/integrations">
  Set up your GitHub integration in the ClosedLoop AI dashboard
</Card>