Linear

Linear is supported as a hosted connector: real webhook, real Discover scan, /align capture in comments. It is not at the same maturity as Slack, Teams, Jira or GitHub, and this page says exactly where the line is.

Off by default

connectors.linear.enabled is false in the chart's default values, so a stock install does not run it. On Align Cloud, ask us to enable it. Self-hosting, set the flag - see Configuration.

What Linear does NOT have

No ambient capture. Slack, Teams, Jira, GitHub and Confluence can notice a decision-shaped conversation and offer to capture it; Linear cannot. Every Linear capture is an explicit /align comment.

If ambient capture on Linear matters to you, tell us - it is a known gap, not a design choice.

What it does

• Capture - /align in a Linear issue comment
• Discover - scan Linear issue and project history for past decisions
• Evidence linking - a decision keeps a link back to the issue that produced it
• CLI import - align import linear builds a personal graph with no account and no connector

Setup

1. Settings → Integrations → Connect next to Linear
2. Authorise Align in Linear
3. Choose which teams are in scope

Capturing a decision

In a comment on any Linear issue:

/align We're moving the notification service off polling and onto webhooks

Align reads the issue and the comment thread for context, creates a Decision Snapshot, and links it back to the issue.

Webhook security

The Linear webhook verifies every delivery with an HMAC signature and rejects the request when no secret is configured. That is deliberate: an unset secret is a misconfiguration, not a reason to accept unsigned traffic. Deliveries are also de-duplicated so a Linear retry cannot create the same decision twice.

OAuth scope

Scope	Why
read	Read issues, comments, projects and teams for context and for Discover

The grant is read-only. Align does not create or modify Linear issues through the connector.

Evidence captured

• Issue link and identifier (for example ENG-123)
• Issue title and status
• Project name
• Team name

Using the CLI instead

You do not need the hosted connector to get Linear history into a graph:

align import linear --token <linear-api-key>

This builds a personal graph on your machine - no shared org graph, no real-time capture, no cross-team conflict detection. See the CLI guide.

Next steps

• Capture - the full per-platform trigger matrix
• Discover - scanning history
• CLI - the free, open-source path