Skip to main content
Linear integration enables automatic issue creation for failures that Bugzy triages as product bugs. When tests fail and Bugzy determines the failure is a genuine product issue, it creates an issue in your Linear team with full reproduction details.

​
What Linear enables

  • Automatic issue creation — Triaged product failures are filed as Linear issues without manual intervention
  • Duplicate detection — Bugzy searches existing issues before creating new ones to avoid duplicates
  • Rich bug reports — Issues include reproduction steps, error details, screenshots, and environment info
  • Priority mapping — Issue priority is set based on failure severity and impact

​
Setup

1

Navigate to connections

Go to Dashboard > Projects > [Your Project] > Connections.
2

Connect Linear

Click Connect Linear. This opens the OAuth flow managed by Nango.
3

Authorize access

Grant access to your Linear workspace.
4

Configure team mapping

After connecting, select the Linear team and project where issues should be created.

​
How issue creation works

The issue creation flow follows the same pattern as Jira bug filing:
  1. Test execution — Bugzy runs tests and collects results
  2. Triage — Bugzy analyzes failures, categorizing each as: product bug, test issue, or environment problem
  3. Duplicate check — For product bugs, the agent searches existing Linear issues to avoid duplicates
  4. Create issue — If no duplicate exists, an issue is created with structured details
  5. Notify team — If Slack/Teams is connected, the team is notified about the new issue

​
Issue contents

Each filed Linear issue includes:
FieldContent
TitleConcise description of the failure
DescriptionDetailed reproduction steps with Markdown formatting
Error detailsStack traces, error messages, assertion failures
Labelsbugzy-automated, test case ID
PriorityBased on failure severity and impact

​
Troubleshooting

Issues not being created — Verify the Linear connection is active and the team mapping is configured. Check that the connected user has permission to create issues in the target team. Duplicate issues being filed — The agent uses title and error signature matching for duplicate detection. If you see duplicates, ensure the team mapping is correct. “Forbidden” errors — The OAuth token may lack required permissions. Disconnect and reconnect Linear from the project connections page to re-authorize.