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

1

Go to Integrations

In Decipher, go to the Integrations page.
2

Connect Linear

Click Connect next to Linear. You’ll be redirected to Linear to authorize Decipher.
3

Authorize Decipher

On Linear, review the permissions (read access and issue creation) and click Authorize. You’ll be redirected back to Decipher.
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

1

Open a failed test run

Navigate to a test and click on a run with a failed status.
2

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.
3

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.
4

Create the issue

Click Create Issue. The issue is created in Linear and linked to the test run in Decipher.

​
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
You can edit the title and description before creating the issue. Add your own notes or remove sections that aren’t relevant.

​
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.
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.

​
Disconnecting Linear

To disconnect the integration:
  1. Go to the 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.