Linear Integration

Connect Linear to your workspace. New comments become issues. Status syncs both ways.

Connect Linear

1

Open Settings

Go to your dashboard and click Settings in the sidebar.

2

Connect your workspace

Click Connect Linear. You'll be redirected to Linear to authorize access. Lay requests read, write, and issue creation scopes.

>
You can disconnect and reconnect at any time from Settings. Disconnecting cleans up webhooks and revokes the token.
3

Select a team per project

Back in your dashboard, open any project. In the Linear section, toggle sync on and pick which team receives issues.

i
New projects auto-enable Linear with your first team if you have an active connection.

How sync works

CommentLayLinear Issuesync

→ New comments create issues with full context

← Status changes in Linear update your dashboard

Comment to Issue

Any root comment on a project with Linear enabled automatically creates an issue. The following data flows into the issue:

  • Title — first line of the comment (max 80 characters)
  • Description — full comment text, author, page URL, element selector
  • Screenshot — annotated screenshot embedded in the issue body
  • AI triage — severity, affected systems, suggested response (if enriched)
i
Replies to a comment become comments on the Linear issue, keeping the thread in sync.

Status sync

DirectionTriggerResult
Dashboard → LinearResolve or archive a commentIssue moves to Done
Linear → DashboardComplete or cancel an issueComment marked resolved
Reopen an issueComment reopened

Status sync is bidirectional and loop-free — each direction uses a separate code path.

Configuration

Multiple projects

Each project can target a different Linear team. Open a project in the dashboard, toggle Linear on, and pick the team from the dropdown.

Disconnecting

Disconnecting Linear from Settings removes:

  • The OAuth connection and tokens
  • All project configurations
  • All issue references (the link between comments and issues)

The Linear issues themselves are not deleted — they stay in your Linear workspace.

!
Reconnecting creates a fresh connection. Previously synced comments won't re-link to their old issues.

Having issues? See Troubleshooting for common problems.