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

# Linear

Compyle's integration with **Linear** allows the AI agent to read your issues and work on them directly within your project.

<Frame caption="Linear Integration Overview">
  <iframe src="https://www.youtube.com/embed/EeE6sok5ZhM?si=pKj0s7b11OjsFcaT" title="Linear Integration" className="w-full aspect-video rounded-xl" />
</Frame>

***

## How it Works

The integration with Linear enables Compyle to directly work on your project issues:

* **Direct Issue Access**: Compyle reads and understands existing issues in your Linear project.
* **Multi-Issue Tasks**: Select one or multiple issues within a single Compyle task.
* **Automated Resolution**: The AI agent solves the attached issues and applies the necessary changes.

***

## Attaching Issues

Compyle allows you to link specific project context to the AI agent by attaching existing Linear issues. This ensures the agent understands the exact requirements, comments, and history associated with a task.

### How to Attach an Issue

1. **Click Icon**: Select the Linear icon when creating a new task.
2. **Search**: Search for the specific issues you want to select.
3. **Select**: Select the issues to provide the agent with the necessary context to work on them.

***

## Setup

Follow these steps to connect Linear to your Compyle organization:

<Steps>
  <Step title="1. Navigate to Settings">
    Go to **Organization Settings** in your dashboard and select the **Integrations** tab from the sidebar.
  </Step>

  <Step title="2. Connect Linear">
    Locate **Linear** and click **Connect** to authorize the application.
  </Step>

  <Step title="3. Connect Workspace">
    Once authorized, your Linear workspace will be linked to Compyle, allowing the agent to read and manage your issues.
  </Step>

  <Step title="4. Finalize Setup">
    Confirm your selections to allow Compyle to start reading and managing your issues.
  </Step>
</Steps>

<Callout icon="id-card" iconType="duotone" color="#3CB878">
  <strong>Prerequisites</strong><br />
  A Linear account with Admin or Workspace owner permissions is required to complete the initial setup.
</Callout>

<Frame caption="Disconnecting Linear from Compyle">
  <iframe src="https://www.youtube.com/embed/QNVo3bt9F2Q?si=aR25jp3f74ClLdZq" title="Disconnecting Linear" className="w-full aspect-video rounded-xl" />
</Frame>

***

## Managing the Integration

* **Team Selection**: Update or add team access at any time through the **Organization Settings** page.
* **Task Integration**: Once Linear is connected, you can select multiple issues within a single task for the agent to analyze and solve.
* **Disconnecting**: To remove the integration, navigate to the **Integrations** tab and click **Disconnect**. This revokes Compyle's access to your Linear workspace.