Warning
Use at your own risk. This script is provided as-is, and the authors are not responsible for any data loss or issues caused during the migration process. Always test with a small subset of data first.
This is a simple script to migrate Trello cards to Linear issues using the Linear API.
- Node.js installed.
- Linear API Key: You can generate one at Linear Settings > API.
- Trello Export JSON: Export your Trello board as JSON (Board > Show Menu > More > Print and Export > Export as JSON).
- Clone this repository or download the files.
- Install dependencies:
npm install
- Create a
.envfile based on.env.example:cp .env.example .env
- Fill in the variables in
.env:LINEAR_API_KEY: Your Linear API key.LINEAR_TEAM_KEY: Your team's key in Linear (e.g., ABC).TRELLO_JSON_PATH: The path to the exported Trello JSON file (default:json-to-import.json(project root)).
Run the migration script:
npm start- Title: Card name.
- Description: Card description + Attachments + Checklists.
- Status: Mapped based on the Trello list name.
- Labels: Mapped if the label name exists in Linear.
- The script ignores archived cards.
- Attachments and Checklists are added to the end of the issue description in Linear.