> ## 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.

# Linear

> Sync your Linear roadmap into ClosedLoop AI: initiatives, projects, and issues connect to customer demand so you see what customers ask for by feature.

Connect Linear to ClosedLoop AI and your roadmap gains customer evidence. ClosedLoop AI syncs your Linear workspace as a roadmap source, then matches customer demand (insights and themes) onto the work you have planned, so you can see the evidence behind every roadmap item and the demand you have not covered yet.

## What Gets Synced

| Data        | Description                                                |
| ----------- | ---------------------------------------------------------- |
| Initiatives | Strategic initiatives that group projects into larger bets |
| Projects    | Bodies of work with status, progress, and target dates     |
| Issues      | Individual work items with state and priority              |

<Note>Linear 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 Linear. There is no lookback window to configure, and roadmap sync does not consume AI analysis credits.</Note>

## Connection Method

Linear uses **OAuth 2.0** authentication. You authorize ClosedLoop AI to read planning data from your Linear workspace.

## Setup Guide

<AccordionGroup>
  <Accordion icon="plug" title="Connect Linear">
    1. In ClosedLoop AI, go to **Settings, Integrations**
    2. Find **Linear** in the integrations list and click **Connect**
    3. You'll be redirected to Linear's authorization page
    4. Sign in and authorize ClosedLoop AI
    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>

## What You Get

Once connected, ClosedLoop AI will:

1. **Sync your initiatives, projects, and issues** in full, keeping the roadmap current with Linear
2. **Project them onto your roadmap** as initiatives and features
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 Linear appear in ClosedLoop AI after the next sync cycle. The sync is read-only: ClosedLoop AI reads your planning data and never writes back to Linear.

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