Connect Linear with GitHub for automatic issue linking, PR management, and development workflow automation. Complete developer guide.
Seamlessly connect your Linear issues with GitHub repositories for enhanced development workflow and traceability.
Go to GitHub marketplace and install the Linear app, or use the integration section in your Linear workspace.
# Install via GitHub CLI gh extension install linear/linear-cli
Grant Linear access to the repositories you want to integrate. You can choose specific repos or allow access to all.
Set up commit message templates that include Linear issue IDs for automatic linking.
# Commit message format examples: git commit -m "Fix login validation - LIN-123" git commit -m "Add user dashboard (closes LIN-456)"
Configure automatic branch creation from Linear issues with consistent naming conventions.
# Auto-generated branch names: feature/LIN-123-add-user-authentication bugfix/LIN-456-fix-payment-flow
Create a Linear issue, branch from it, make a commit with the issue ID, and verify the integration works.
Ensure commit messages include the correct Linear issue ID format (LIN-XXX) and that the repository is connected.
Check that the Linear GitHub app has write permissions to your repository and that branch protection rules allow creation.
Verify that the PR description or commits reference the Linear issue ID and that status automation is enabled.
Start with linear.gratis and connect your GitHub workflow. Free setup, no limits, ready in minutes.