Linear

Send Duku findings to Linear and track ticket progress in the issue inbox.

Linear integration overview

The Linear integration lets you file a Duku issue as a ticket in Linear. Duku creates the ticket from the issue, then keeps its ticket stage up to date in the issue inbox.

The integration is configured once for your organisation. Choose a Linear team as the destination, then create tickets from individual issue detail pages.

A ticket's stage and a Duku issue's status are separate. Stage shows the partner's progress in Linear. Status is Duku's triage judgement: Open, Triaged, Resolved, or Ignored. Only a person changes status in Duku. An issue can be Open with a ticket stage of Landed. This is expected.

Prerequisites

• You are an organisation admin in Duku.

• You have a Linear workspace and can authorise third-party apps in it.

• You configure the integration per organisation, not per product.

• Connecting Linear and choosing the destination need an org admin. Any org member can file tickets.

Connecting Linear

1. Integrations before you connect

Connect Linear in Organisation settings

1. Open Organisation settings → Integrations.

2. Select + Connect.

3. Choose provider linear and variant cloud.

4. Select Connect with linear (OAuth).

2. Connect dialog

Connect Linear with OAuth

1. In the Linear popup, authorise Duku for your workspace.

The popup closes and returns you to Duku after authorisation.

Choosing where tickets are filed

After you connect, Duku opens the destination picker. It lists the teams in your Linear workspace.

Choose the team where new tickets should be created. Until you set a destination, the connection shows Pending setup. You can change the destination later from the same row.

3. Linear is connected

Linear connection in Organisation settings

Filing an issue

Open an issue and find the Ticket row in the Details card. Select Create ticket.

4. Create a ticket from an issue

Create a ticket from the issue Details card

The dialog includes optional Title override and Body override fields. Leave both blank. Duku fills the ticket from the issue itself.

Create ticket dialog

What ends up in the ticket

Duku creates the ticket with:

• The issue title as the ticket title.

• The issue analysis and the reporter's grouping rationale as the description.

• A Duku issue attachment that links back to the issue.

5. Filed ticket in Duku

Filed Linear ticket in Duku

After filing, the Ticket row shows the Linear key, such as ENG-412, as a link. It also shows the current stage and filing time.

6. Ticket in Linear

Linear ticket created from the Duku issue

How the stage syncs back

Duku watches the Linear ticket and updates its stage in the issue inbox.

Linear state	Stage in Duku
Triage, Backlog	Confirmed
Todo, In Progress	In remediation
Done	Landed
Canceled (including Duplicate)	Rejected

7. Ticket stage in Duku

Landed ticket stage in Duku

Landed identifies findings that were fixed. Rejected also marks the issue as a false positive. This feeds Duku's detection-quality measurement.

Closing a Linear ticket changes its ticket stage. It does not change the Duku issue's status.

Disconnecting

Disconnecting removes the connection and stops new tickets being filed. Existing tickets stay in Linear, and Duku stops updating their stage.