Linear
Learn how to use Tunnel with Linear
Overview
The Linear integration allows you to create issues in Linear from Tunnel comments. You can also set default issue properties and automatically create issues in Linear with every comment.
Configuration
You can configure the Linear integration in the Tunnel Dashboard by navigating to Settings > Profile and scrolling to the Integrations section.
Connect Linear
Go to the Tunnel Dashboard. Click Connect to connect your Linear organization.
Create issues
Manually
With your Linear account connected, you can create issues in Linear from Tunnel comments.
Open the integrations dropdown menu
To attach a Linear issue to a comment, open the integrations dropdown menu from the Create button. Select Create issue in the Linear row.
Set issue properties
Set the team, project, status, labels, assignee, and priority for the issue.
Submit the comment to create the issue
When you submit the comment, the issue will be created in Linear and a link to the issue will be added to the comment.
Automatically
You can also set default issue properties and automatically create issues in Linear with every comment.
Add default issue properties
Go to the Tunnel Dashboard and navigate to Settings > Profile. Scroll to the Integrations section and click Manage in the Linear row.
From here, you can set a default Linear team, and then set default values for project, status, assignee, and priority. You can also set default labels.
(Optional) Turn on automatic issue creation
In your default Linear settings, you also have the option to turn on automatic issue creation. This will create a new issue in Linear for every you create comment in Tunnel.
Create an issue
With your default settings configured, you can easily create an issue in Linear from a comment. To attach a Linear issue to a comment, open the integrations dropdown menu from the Create button. Select Create issue in the Linear row.
When you submit the comment, the issue will be created in Linear with your default settings and a link to the issue will be added to the comment.
If you have automatic issue creation turned on, you’ll see the Linear icon at the bottom of comment box. You can click it to override your default settings and create an issue with custom properties. Otherwise, an issue will be created with your default settings when you submit the comment.
