Linear Integration
Connect your Linear workspace to automatically link pull requests to Linear issues and group them by project in your weekly changelogs. Coderbuds syncs your Linear teams, projects, and issues so you can see exactly which features shipped each week.
Key Features
Automatic PR Linking
Extracts Linear issue keys like ENG-123 from PR titles and descriptions to automatically link them.
Project Sync
Syncs your Linear teams, projects, and issues in the background. Select which teams to track and trigger re-syncs at any time.
Changelog Grouping
Pull requests are grouped under their Linear projects in your weekly changelog, giving you a feature-level view of what shipped.
How It Works
The Linear integration connects via OAuth and syncs your workspace data in the background. Once connected, Coderbuds automatically matches pull requests to Linear issues by scanning PR titles and descriptions for issue keys.
Connect Linear
Authorize Coderbuds via OAuth from your Team Settings.
Select Teams
Choose which Linear teams to sync and track issues from.
PRs Linked Automatically
Mention issue keys in your PRs and they're linked instantly.
View in Changelog
See PRs grouped by Linear project in your weekly changelog.
Setup Guide
Navigate to Team Settings
Go to your team's settings page and open the Integrations tab. You'll see the Linear section with a "Connect Linear" button.
Authorize with Linear
Click "Connect Linear" to start the OAuth flow. You'll be redirected to Linear to authorize Coderbuds with read access to your workspace.
Select Teams to Sync
After connecting, you'll see a list of your Linear teams. Check the teams you'd like to sync and click Save & Sync. Coderbuds will begin syncing projects and issues in the background.
Wait for Initial Sync
The initial sync runs as a background job. You'll see the sync status and last synced timestamp update automatically. Existing PRs are also scanned and linked during this process.
PR Linking
Coderbuds scans pull request titles and descriptions for Linear issue keys using the pattern [A-Z][A-Z0-9]+-\d+. Any matching keys are automatically linked to their corresponding Linear issues.
ENG-123: Add user authentication Fix login bug (resolves ENG-456) [ENG-789] Refactor database queries feat: implement search - ENG-101
Tip: Include the Linear issue key anywhere in your PR title or description. The key format matches your Linear team prefix (e.g., ENG, CORE, FE) followed by a number.
Managing Your Connection
Re-syncing
Trigger a manual re-sync at any time from Team Settings. This fetches the latest projects and issues from Linear and re-links any new PRs.
Changing Synced Teams
You can update which Linear teams are synced at any time. Check or uncheck teams and save to adjust what gets tracked.
Disconnecting
Click "Disconnect" in Team Settings to remove the Linear connection. This revokes the OAuth token and removes all synced Linear data. PR links are preserved for historical reference.
Changelog Integration
Once Linear is connected, your weekly changelog groups pull requests under their associated Linear projects. This gives you a feature-level view of what shipped each week:
- Projects tab groups PRs by their Linear project, showing which features progressed
- Standalone issues are listed separately when they aren't part of a project
- AI-generated summaries describe what each project delivered that week
Using Linear with Jira
Coderbuds supports connecting both Linear and Jira simultaneously. Pull requests can be linked to issues from either tool, and changelogs will show groupings from both providers. This is useful for teams transitioning between tools or using different tools for different workstreams.
Troubleshooting
PRs aren't being linked
Check that your PR title or description contains a valid Linear issue key (e.g., ENG-123). The key must match a team prefix from a synced Linear team. Make sure the issue exists and has been synced.
Sync seems stuck
Syncing runs as a background job and may take a few minutes for large workspaces. If the last synced timestamp hasn't updated after several minutes, try triggering a manual re-sync from Team Settings.
Connection expired
Coderbuds automatically refreshes OAuth tokens. If your connection shows as expired, try disconnecting and reconnecting Linear from Team Settings.
Data & Privacy
Coderbuds requests read-only access to your Linear workspace. We sync team names, project names, issue keys, summaries, and statuses. No issue descriptions, comments, or attachments are stored. OAuth tokens are encrypted and can be revoked at any time by disconnecting from Team Settings. See our Security documentation for more details.