Integrations
GitHub

Connect GitHub to Linear to automate PR workflows, sync issues, and understand your codebase

Searching "git" in the command menu, with a resulting item "copy git branch name to clipboard". — A single shortcut to assign yourself an issue, mark it as In Progress, and copy the git branch name to your clipboard

A GitHub Pull Request linked to a Linear issue. — Pull Requests are bi-directionally linked to Linear issues

Overview⁠

Linear’s GitHub integration keeps your development workflow connected across both applications. You can link Linear issues to pull requests and commits, automate issue status based on PR activity, and review pull requests in Linear with Diffs.

Issues created in GitHub can sync to Linear automatically, with comments and other updates reflected both ways. You can also create a branch name for the Linear issue, assign it to yourself, and move it to In Progress with a keyboard shortcut.

With repository code access enabled, Linear Agent can answer questions about your codebase and analyze pull requests through Code Intelligence, while Diffs lets you review pull requests directly in Linear with synced comments, checks, and review state.

How it works⁠

Configure the GitHub integration in a couple of minutes by authenticating and selecting which repos to connect to Linear. Once connected, members can start linking pull requests and commits, configure workflow automations, and review pull requests directly in Linear.

Link PRs and commits 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/commit status. Turn on a couple of account preferences settings to enable personal GitHub automations that auto-assign issues and move them to In Progress.

Connect your chosen repos to sync newly created GitHub issues to your desired teams on Linear — useful for open source projects. Comments, status, assignee and other states are synced both ways between Linear and GitHub.

Repository code access allows Linear Agent to inspect code and analyze pull requests with source-backed context, while displaying diffs, changed files, comments, checks, and review activity directly in your Reviews tab.

Configure⁠

A Linear owner or admin with Github organization owner access can enable the GitHub integration and grant code access for the workspace in Settings.

Once enabled, workspace members can configure PR automation under team workflow settings and personal git automations under account preferences. Learn about advanced configuration options, including auto-link and connecting a GitHub Enterprise Cloud account.

GitHub Issues can be linked to a repository and Linear team so new GitHub issues sync to Linear automatically, with comments and updates reflected across both tools.

Reviews⁠

The Reviews tab lets you review pull requests end-to-end directly in Linear. This includes pull request diffs for code review, along with comments, checks, and review activity synced automatically with GitHub.

Learn more about Diffs and setup requirements.