DevFlow
Docs/Integrations

Linear integration: incidents to issues

Owner Theo Hayashi · Last updated 2026-03-14 · v2.1
linearintegrationissuesincident-to-ticketworkflow

Linear integration

DevFlow can create a Linear issue from an incident, automatically or on a button click.

install

Settings → Integrations → Linear → Install. The OAuth flow needs read+write on issues for the team you intend to write to.

attaching to a project

bash
devflow integrations linear configure   --team ENG   --label "incident,from-devflow"   --auto-create-on critical

--auto-create-on critical makes any critical-severity incident auto-create a Linear issue. Otherwise, the incident page has a "Create Linear issue" button.

what's in the issue

  • Title — [DevFlow] payments-api-charge — 2026-04-15 14:32 UTC
  • Description — incident metadata, link back to DevFlow, assertion that failed, region quorum.
  • Labels — incident, from-devflow, plus your configured labels.
  • Project — defaults to none; you can set per-tag-selector mapping in the dashboard.

status sync

When the Linear issue is moved to Done, the DevFlow incident gets a "linked Linear issue resolved" annotation. We do not auto-resolve the DevFlow incident on Linear status — auto-resolve in DevFlow follows the incident-management rules.

removing

OAuth grant can be revoked from Linear; DevFlow detects within 60s.

Related questions

Was this helpful?
Or ask the docs bot for a follow-up — the floating button bottom-right.