denniszon / linear-import

Linear importers

linear-import

Install depedencies:

yarn install

Run interactive importer:

yarn cli

Importers

It's recommended to only import open issues to keep your Linear account more manageable.

GitHub

Open GitHub issues can be imported with your personal access token from GitHub's API.

Supported fields:

• Title
• Description
• Labels
• (Optional) Comments

Jira CSV

Jira project can be imported into a Linear team from the CSV export file.

Following fields are supported:

• Summary - Issue title
• Description - Converted into markdown and used as issue description
• Priority - Issue priority
• Issue Type - Added as a label
• (Optional) Release - Added as a label

Asana CSV

Asana projects can be imported into a Linear team from the CSV export file.

Following fields are supported:

• Name - Issue title
• Notes - Converted into markdown and used as issue description
• Priority - Issue priority
• Tags - Added as a label
• Assignee - Issue assignee

Pivotal Tracker CSV

Pivotal Tracker projects can be imported into a Linear team from the CSV export file. It only imports chores, features, and bugs.

Following fields are supported:

• Title - Issue title
• Description - Converted into markdown and used as issue description
• Labels - Added as a label
• Owned By - Story owner
• URL - URL of Pivotal Tracker story
• Created at - Preserves the story creation date

Trello JSON

Trello board can be imported into a Linear team from the JSON export file, which can be obtained by going into Board → Show Menu → More → Print and Export → Export as JSON.

Following fields are supported:

• Name - Issue title
• Description - Trello markdown formatted description
• URL - URL of Trello card
• Labels - Added as a label

Linear CSV

Linear CSV exports (Settings → Import / Export → Export CSV) can be imported into Linear again. You can use this to import issues from one workspace to another. Archived issues won't be imported.

Following fields are supported:

• Title - Issue title
• Description - Issue description
• Priority - Issue priority
• Status - Issue state (workflow)
• Assignee - Issue assignee
• Labels - Added as a label

Todo

• Automatic image uploads
• Assignees (pick from a list)
• Created at (requires API change)