GitHub

Linear's GitHub integration is so perfect it tickles my brain. It ties task management to git. From git-blame to GitHub PR to Linear task, all linked. I love the way you "stumble towards success" using it, as long as you start with the right branch name.

Majd Taby, Darkroom

Overview

This powerful GitHub integration keeps your work in sync in both applications. It links issues to Pull Requests so that issues update automatically from In Progress to Done as the PR moves from drafted to merged – there is no need to update the issue in Linear at all. Move even faster by using a keyboard shortcut that creates the issue's git branch name, assigns the issue and moves the issue to In Progress in one step. This integration supports GitHub Enterprise.

How it works

Configure the GitHub integration in a couple of minutes by authenticating and selecting which repos to connect to Linear. Once you do, anyone in the workspace can start linking PRs.

Link PRs to issues in a few ways. Use the issue ID in the branch name or PR title before creating the PR. To link multiple PRs, or link issues after creating the PR, use magic words along with the issue ID in the PR description or commit message. This will create a link to the PR in the Linear issue and a linkback to Linear from the PR.

Set workflow automations on a per team basis so that issues move through different issue statuses based on PR status. Turn on a couple of account preferences settings to enable personal GitHub automations that auto-assign issues and move them to In Progress.

Configure

A Linear admin can enable this integration for the workspace in settings. GitHub PR linking and linking via commits are enabled seperately.

Once enabled, any workspace member can see and configure PR automation under team workflow settings and personal git automations under account preferences. Learn about advanced configuration options to enable autolink or to connect a GitHub Enterprise account.