Skip to main content

Setup

If you have not integrated Spur with Linear, follow the setup process here.

Overview

Connect Linear to create issues from test failures. You can choose which team and project to send issues to, along with details such as priority, assignee, and labels. Paste a Linear ticket link into Spur AI and ask it to draft tests from the requirements and attached images.

Set your defaults

Once connected, click Settings on the Linear card to open Linear Integration Settings. Select a Default Team and, optionally, a Default Project.

Auto-create tickets

Turn on Auto-Create Linear Tickets to have Spur create a Linear issue automatically when a test finishes. Turning it on selects both When a test fails and When a test passes. Clear When a test passes if you only want issues for failures. Auto-create needs a default team. Click Save Changes to apply your settings.

Creating a ticket manually from a test failure

1

Open the share menu

After reviewing a test run, open the Share menu and click Linear under Create a Ticket to open the Linear issue creation modal:
Share menu with the Create a Ticket option

Bug report initiation showing the Share menu and the Create a Ticket options

2

Linear issue creation modal

The modal opens with pre-populated information from the test failure:
Linear issue creation modal with auto-generated title and description

Linear issue creation modal with auto-generated content

Auto-Generated Fields:
  • Title: Name of the Test
  • Description: Detailed bug report including:
    • Failure Reason
    • Reproduction steps
    • Test name and execution details
  • Team: The default team, if chosen in the Integrations page.
3

Customize issue details

Edit the title and description, if necessary. Choose additional issue details.
Additional Linear issue fields: project, assignee, priority, labels, and state

Customizing issue details with additional information

Customization Options:
  • Project: Choose the Linear project for the issue. This is optional.
  • Assignee: Set who should handle the issue. You can also delegate the issue to an AI agent connected to your Linear workspace, such as Cursor.
  • Priority: Set the urgency of the bug.
  • Labels: Attach any labels that are allowed within the selected team.
  • State: Choose the current status of the issue
4

Submit and track

Click Create Ticket. Spur files the issue in Linear and links it to the test run.

Troubleshooting

Common issues

Reconnect required:
  • Linear rejected Spur’s stored token. Click Reconnect on the Linear card on the Integrations page. Your settings are kept.
If fields are missing:
  • Your integration permissions may not be set properly. Try reintegrating from the Integrations page.
Issue Creation Failures:
  • Confirm you have chosen a proper team
  • Check required field configurations
Custom Required Fields:
  • If your Linear workspace has custom required fields, contact the Spur team for assistance with your integration setup.