Linear

You can import tasks from Linear.app using the linear service name.

Example Service

Here’s an example of a Linear target:

toml

[my_issues]
service = "linear"
api_token = "<your API token>"

ini

[my_issues]
service = linear
linear.api_token = <your API token>

The above example is the minimum required to import issues from Linear. You can also feel free to use any of the configuration options described in Common Service Configuration Options.

Options

api_token

Linear offers API keys at Settings -> Security & Access -> Personal API Keys. You will need to provide api_token to allow bugwarrior to read issues. The token needs only Read access.

import_labels_as_tags

A boolean that indicates whether the Linear labels should be imported as tags in taskwarrior. (Defaults to false.)

label_template

Template used to convert Linear labels to taskwarrior tags. See Field Templates for more details regarding how templates are processed. The default value is {{label|replace(' ', '_')}}.

status_types

Comma-separated list of Linear status types that should be included. The default statuses for a team and any custom statuses fall into one of a few pre-defined types: backlog, unstarted, started, completed, and canceled, and are case-sensitive. See https://linear.app/docs/configuring-workflows#overview. The default value is:

toml

status_types = ["backlog", "unstarted", "started"]

ini

linear.status_types = backlog,unstarted,started

statuses

If filtering by status types is not sufficient, this option allows filtering by a comma-separated list of status names. For example, if your team has a “Not A Priority” status with type “Canceled”, which you would like to include, use:

toml

statuses = ["Backlog", "Todo", "In Progress", "Not A Priority"]

ini

linear.statuses = Backlog,Todo,In Progress,Not A Priority

These values are case-sensitive. This setting overrides the default value of status_types.

Provided UDA Fields

Field Name	Description	Type
linearassignee	Issue Assignee	Text (string)
linearclosed	Issue Closed	Date & Time (date)
linearcreated	Issue Created	Date & Time (date)
linearcreator	Issue Creator	Text (string)
lineardescription	Issue Description	Text (string)
linearidentifier	Linear Identifier	Text (string)
linearstatus	Issue State	Text (string)
linearteam	Project ID	Text (string)
lineartitle	Issue Title	Text (string)
linearupdated	Issue Updated	Date & Time (date)
linearurl	Issue URL	Text (string)