Skip to main content
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.

​
Linear App Authentication

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

​
Installation steps:

1
Go to the Qodo integrations page.
2
Navigate to the Integrations tab.
3
Click on the Linear button to connect the Linear app.
4
Follow the authentication flow to authorize Qodo to access your Linear workspace.
5
Once connected, Qodo will be able to fetch Linear ticket context for your PRs.
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 under the [linear] section: 
[linear]
linear_base_url = "https://linear.app/[ORG_ID]" # your Linear organization identifier