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

# Linear integration

> Create Linear issues from failed test runs with full failure context

Decipher's Linear integration lets you create Linear issues directly from failed test runs. Each issue is pre-filled with failure details, suggested fixes, and a link back to the run in Decipher.

## Step 1: Connect Linear

<Steps>
  <Step title="Go to Integrations">
    In Decipher, go to the [**Integrations**](https://www.app.getdecipher.com/integrations) page.
  </Step>

  <Step title="Connect Linear">
    Click **Connect** next to **Linear**. You'll be redirected to Linear to authorize Decipher.
  </Step>

  <Step title="Authorize Decipher">
    On Linear, review the permissions (read access and issue creation) and click **Authorize**. You'll be redirected back to Decipher.
  </Step>
</Steps>

Once connected, you'll see a confirmation on the Integrations page. The integration is shared across your Decipher organization — any team member can create issues once it's set up.

## Step 2: Create an issue from a failed test run

<Steps>
  <Step title="Open a failed test run">
    Navigate to a test and click on a run with a **failed** status.
  </Step>

  <Step title="Click the Linear button">
    Click the **Export** button (with the Linear icon) next to the run status badge. If Linear isn't connected, you'll be prompted to set it up on the Integrations page.
  </Step>

  <Step title="Review and customize the issue">
    A dialog opens with the title and description pre-filled from the failure. Select a **team**, and optionally set an assignee, project, label, or priority. You can edit any field before creating.
  </Step>

  <Step title="Create the issue">
    Click **Create Issue**. The issue is created in Linear and linked to the test run in Decipher.
  </Step>
</Steps>

## What's included in the issue

Decipher automatically generates the issue description with:

* **Failure summary** — what went wrong and why
* **Link to the run** — direct link to the run in Decipher
* **Test context** — test name, target URL, run status, and timestamp
* **Failure classification** — type and reason for the failure (if available)
* **Failed steps** — detailed breakdown of which steps failed and how
* **Suggested fixes** — AI-generated recommendations for resolving the failure

<Tip>
  You can edit the title and description before creating the issue. Add your own notes or remove sections that aren't relevant.
</Tip>

## Viewing linked issues

After creating an issue, the Export button on the test run is replaced with a link showing the Linear issue identifier (e.g., **ENG-123**). Click it to open the issue directly in Linear.

<Note>
  Each test run can have one linked Linear issue. If an issue has already been created for a run, the button shows the existing issue link instead of the create option.
</Note>

## Disconnecting Linear

To disconnect the integration:

1. Go to the [**Integrations**](https://www.app.getdecipher.com/integrations) page
2. Click **Disconnect** next to Linear

This revokes Decipher's access to your Linear workspace. Existing issues in Linear are not affected, but you won't be able to create new ones from Decipher until you reconnect.

***

*Need help? [Contact our support team](mailto:team@getdecipher.com).*