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

# Linear

<Warning>
  **Git Integration (formerly Qodo Merge)** – AI code review agents for pull requests. This documentation describes the Qodo v1 experience. For the Qodo v2 documentation, click [here.](/code-review)
</Warning>

### Linear app authentication

The recommended way to authenticate with Linear is to connect the Linear app through the Qodo portal.

#### Installation steps:

<Steps>
  <Step>
    Go to the [Qodo integrations page](https://app.qodo.ai/qodo-merge/integrations).
  </Step>

  <Step>
    Navigate to the **Integrations** tab.
  </Step>

  <Step>
    Click on the **Linear** button to connect the Linear app.
  </Step>

  <Step>
    Follow the authentication flow to authorize Qodo to access your Linear workspace.
  </Step>

  <Step>
    Once connected, Qodo will be able to fetch Linear ticket context for your PRs.
  </Step>
</Steps>

### How to link a PR to a Linear ticket

Qodo will automatically detect Linear tickets using either of these methods:

#### **Method 1: Description reference:**

Include a ticket reference in your PR description using either:

* **The complete Linear ticket URL:** `https://linear.app/[ORG_ID]/issue/[TICKET_ID]`
* **The shortened ticket ID:** `[TICKET_ID]` (e.g., `ABC-123`) This method requires `linear_base_url` configuration (see below).

#### **Method 2: Branch name detection:**

Name your branch with the ticket ID as a prefix (e.g., `ABC-123-feature-description` or `feature/ABC-123/feature-description`).

### Linear base URL

For shortened ticket IDs or branch detection, you must configure the Linear base URL in your [configuration file](/v1/configuration/configuration-file) under the \[linear] section:

```bash theme={null}
[linear]
linear_base_url = "https://linear.app/[ORG_ID]" # your Linear organization identifier
```