Skip to main content
This feature is available exclusively as part of the Pro plan. Please refer to our pricing page for more information about our plans and features.

​
Overview

The Linear integration connects CodeRabbit to your Linear workspace, bringing issue context into every stage of development. Here’s what the integration enables:

Context enrichment

Pulls in Linear issue details so CodeRabbit understands why a change is being made

Requirement validation

Assesses whether code changes address the linked issue’s acceptance criteria

Issue planning

Generates step-by-step Coding Plans from Linear issues for coding agents and IDE copilots

Issue creation

Creates new Linear issues directly from PR review comments

​
Prerequisites

Before setting up the Linear integration, ensure you have:
  • A Linear account with access to the workspace you want to connect
  • A CodeRabbit Pro plan

​
Install the Linear integration

The Linear integration uses OAuth authentication to securely connect your Linear workspace to CodeRabbit.
1

Enable Linear integration

Navigate to Integrations in the CodeRabbit app and toggle Linear to enable the integration.
2

Authenticate with Linear

You will be redirected to Linear’s login page. Enter your credentials to authorize CodeRabbit to access your Linear workspace.

​
Configure CodeRabbit for Linear

After connecting Linear, configure which Linear teams CodeRabbit should access by adding your team keys. The team key is a short team identifier—for example, if your issue URL is https://linear.app/company/issue/DEV-123, the team key is DEV.
Add the team_keys setting under knowledge_base.linear in your .coderabbit.yaml file:
.coderabbit.yaml
# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
knowledge_base:
  linear:
    usage: "enabled"
    team_keys:
      - "DEV"
      - "ENG"

chat:
  integrations:
    linear:
      usage: "enabled"
The usage setting controls when the integration is active:
  • auto (default): Disabled for public repositories, enabled for private repositories
  • enabled: Always enabled
  • disabled: Always disabled
By default, Linear integration is enabled for private repositories and disabled for public repositories. You can override this behavior by setting knowledge_base.linear.usage: enabled and chat.integrations.linear.usage: enabled in your .coderabbit.yaml file or using the web interface. See the Configuration reference for details.

​
Example usage

​
Linking Linear issues to pull requests

To have CodeRabbit validate requirements from a Linear issue, include the issue URL in your pull request description: 
This PR implements the user authentication flow.

Closes https://linear.app/company/issue/DEV-123
CodeRabbit will fetch the issue details and assess whether your code changes address the requirements specified in the issue. See the Linked issues guide for best practices on linking issues.

​
Creating Linear issues from reviews

During a code review, you can ask CodeRabbit to create a Linear issue by mentioning @coderabbitai in a comment: 
@coderabbitai create a Linear issue for this bug in the DEV team
CodeRabbit will create a well-structured issue with relevant context from the code review discussion. See the Issue creation guide for more details.

Requirement validation

Best practices for linking issues to pull requests

Issue planning

Generate Coding Plans from issues for coding agents

Issue creation

Create issues directly from CodeRabbit reviews