Linear

Connect Linear so Canary assistants and workflows can look up issue details and reference Linear tickets during QA workflows, including from Slack assistant threads.

Connect Linear so work doesn't stop at the issue. Turn an issue into a test, test issues from Slack, and file defects back — without leaving the issue tracker your team already uses.

Connect once in Settings, and you can:

Turn an issue into a test — import it into the workflow builder with a suggested goal.
Test an issue from Slack — ask the Slack assistant to run an ad-hoc test for an issue.
File defects to Linear — push a Cofactor issue back as a Linear issue.
Look up issues from Slack — search connected Linear issues in assistant threads.
Keep issues current — Cofactor closes linked Linear issues automatically through a webhook.

01Connect Linear

You need admin access in Cofactor and permission to authorize apps in Linear.

Open Settings > Linear under Integrations.
Click Connect Linear, sign in, review access, and Authorize.
Return to Cofactor and confirm the connection is active.

Cofactor registers a webhook for your workspace as part of setup. The settings page shows whether the webhook is configured.

Settings → Integrations → Linear — authorize the workspace Cofactor can search

02Turn a Linear issue into a test

Import an issue into the workflow builder instead of retyping it.

Open the workflow builder import flow and select Linear.
Search by key (e.g. ENG-123), title, or details.
Select the issue to pull in its details.
Review the suggested goal and context, then continue into the builder.

Cofactor reads the issue and proposes a starting goal, so you begin with a draft instead of a blank canvas.

03Test an issue from Slack

In a Slack assistant thread, tell the assistant to test an issue and it launches an ad-hoc test. The request, progress, and results stay in the thread. (Result write-back onto the issue is Jira-only today — for Linear, the verdict and replays live in Slack and Cofactor.)

04File a Cofactor issue back to Linear

When testing surfaces a defect, create a Linear issue from the Cofactor issue to hand it to your team — keeping testing output in the Linear process you already use. You can target a specific team, project, or labels when you create it.

05Look up Linear issues from Slack

Pull issue details into a conversation without switching tools.

In a connected Slack assistant thread, ask for an issue by key, title, or topic.
Review the results and continue with follow-ups about status, ownership, or related work.

Include the issue key when you know it. Common asks:

Find Linear ticket ENG-123
Search Linear for login timeout issue
What Linear issue tracks the onboarding modal bug?

06Status sync

Cofactor registers a webhook when you connect Linear and uses it to keep things current — for example, closing the linked Canary issue when its Linear issue is completed or canceled. The Linear settings page shows whether the webhook is configured; reconnect Linear if it isn't.

07Troubleshooting

Problem	What to do
Can't find the issue to import	Confirm it exists in the connected workspace and you have access, then search by key (`ENG-123`) or a sharper title.
Import error	Re-open the import flow, verify the connection, and retry. Reconnect Linear if it persists.
Reframing error after import	Import again; check the title and description have enough detail. Add context in Linear if sparse.
Slack lookups return nothing	Confirm Linear shows as connected in Settings > Integrations, you authorized the right workspace, and you're in a workspace where the Cofactor app is available. Search with the exact key.
Webhook shows as not configured	Reconnect Linear from Settings > Integrations to re-register it.

Slack
Jira — adds tag-triggered runs and result write-back
Ad-hoc testing — mention a Linear key and the run gets its context
Runs