IntegrationPowered by GAIA

Automate GitHub + Linear with GAIA

Sync GitHub PRs and issues with Linear tickets automatically

Linear's own GitHub integration links pull requests, branches and commits to Linear issues and moves issue status for you, with no extra tool. Connect it in Linear under Settings > Integrations > GitHub, then put the issue ID (like ENG-123) in the branch name, PR title or PR description; copying the git branch name from a Linear issue does this for you. In each team's workflow settings, choose the status an issue moves to when you copy its branch name or open a draft PR, when a PR opens or review is requested, and when the PR merges (usually Done). You can add rules per target branch, for example In QA on merge to staging and Done on merge to main. A closing word such as "Fixes ENG-123" in the PR description also closes the issue on merge.

If that covers your team, you do not need GAIA for status updates. GAIA is for the work the native integration does not do: steps that cross more tools or need judgment. GAIA's GitHub triggers fire on pull request events, new issues and pushed commits in the repositories you pick, and its Linear triggers fire when an issue is created or updated or a comment is added in a team you pick. A workflow written in plain English then acts with GAIA's GitHub, Linear, Slack and Gmail tools: post a Slack summary of what merged today, draft release notes from the issues closed this week, or turn alert emails into triaged Linear issues.

An example workflow: "When a pull request is merged in acme/api, find the Linear issue IDs in its branch name and title, comment on each issue with the PR link, and post a one-line summary to #releases in Slack."

5 things you can automate

Everything GAIA can do when GitHub and Linear are connected.

Auto-update Linear issue status from PR events

When a PR is opened referencing a Linear issue, GAIA moves the issue to 'In Review'. When the PR merges, GAIA marks the issue as 'Done'. The Linear board always reflects actual code state.

Create Linear issues from GitHub issues

Bug reports and feature requests filed in GitHub can automatically create corresponding Linear tickets, ensuring engineering backlog and GitHub issue tracker stay in sync.

PR cycle time reporting

GAIA tracks the time from Linear issue creation to GitHub PR merge and generates weekly reports showing cycle time by team member and issue type to identify bottlenecks.

Branch naming convention checks

On a schedule you set, GAIA lists open pull requests in the repositories you choose and flags any whose branch name or title has no Linear issue ID, so untracked work shows up before review.

Release notes generation

When PRs are merged to main, GAIA compiles the linked Linear issues into structured release notes organized by feature area, ready for the changelog or product announcement.

How to set it up

Connect GitHub and Linear to GAIA in three steps.

1
Connect GitHub and Linear to GAIA
Authorize GAIA with your GitHub organization and Linear workspace. Select which repositories and Linear teams to synchronize.
2
Describe the workflow in plain English
Pick a GitHub trigger (pull request event, new issue or pushed commit) or a Linear trigger (issue created, issue updated or comment added), then write what GAIA should do, for example "when a PR against main references a Linear issue, comment the PR link on the issue". GAIA runs each step with its GitHub and Linear tools.
3
Check what ran
Every workflow run is recorded, and GAIA can notify you when it acts. You can also ask GAIA at any time to compare open PRs with Linear issue states and list the mismatches.

Frequently Asked Questions

GAIA looks for Linear issue IDs in PR titles and branch names (like 'ENG-123' or 'feature/ENG-123-user-auth'). It can also parse PR descriptions for Linear issue URLs. Most engineering teams already use these conventions.

GAIA updates all referenced Linear issues when the PR status changes. This is common for large PRs that resolve several related issues simultaneously.

Not as a live mirror. A workflow on GAIA's Linear issue updated trigger can add or change labels on the linked GitHub PR when an issue changes, using GAIA's GitHub tools. It runs once per event in one direction, so treat it as automation, not two-way sync.

Use Linear's own integration; GAIA is not needed for this. Connect GitHub in Linear under Settings > Integrations > GitHub, open your team's workflow settings and set the PR merge automation to Done. Put the issue ID in the branch name, PR title or description so Linear can link the PR to the issue.

Linear's branch rules let you set a different status per target branch, so a merge to staging can move issues to In QA and a merge to your release or main branch can move them to Done. If a release is a tag or a deploy rather than a merge, GAIA can run a workflow on pushed commits or on a schedule, find the issues that shipped and update them.

Start with your monitoring tool's native integrations: error trackers such as Sentry can create Linear and GitHub issues from alerts. If your alerts arrive by email, GAIA's Gmail trigger can start a workflow on each alert email that checks for an existing open issue and, if there is none, creates a Linear or GitHub issue with the error, service and link.

Explore individual integrations

GitHub Integration

See everything GAIA can do with GitHub, including triggers, actions, and ready-made workflows.

Linear Integration

Discover the full set of Linear automations available through GAIA.

Compare the tools

GAIA vs Linear: full comparison

See how GAIA compares to Linear head-to-head.

Related Automations

Gmail + Linear

Bridge customer emails and engineering issues automatically

Slack + Linear

Create and update Linear issues directly from Slack conversations

Slack + GitHub

Get GitHub notifications in Slack and manage PRs from chat

Guides in the Docs

Managing Tasks & Todos

docs.heygaia.io

Explore more automation combos

GAIA supports dozens of tool combinations. Explore more ways to automate your workflow.

Browse marketplace

5 things you can automate

Everything GAIA can do when GitHub and Linear are connected.

Auto-update Linear issue status from PR events

When a PR is opened referencing a Linear issue, GAIA moves the issue to 'In Review'. When the PR merges, GAIA marks the issue as 'Done'. The Linear board always reflects actual code state.