Moving from Linear

Before you start

At the time of checking, Linear exports issues as CSV from any view, project or issue list (open the command menu with Ctrl/⌘+K and choose Export issues as CSV…), with columns including ID, Team, Title, Description, Status, Estimate, Priority, Project, Assignee, Labels, Due Date and Parent issue. Members can export up to 250 issues at a time; admins more. Trust your own file over this page.

OpenTodo reads a CSV with a header row and a title column; header names are case-insensitive and spaces count as underscores, so Title, Description, Project, Labels and Due Date are read as they are. The columns it understands are in the import reference.

Export from Linear

1. Open the view or project to move, press Ctrl/⌘+K and choose Export issues as CSV…. Repeat per team or project if you have more than the limit. Import formats
2. Open the file in a spreadsheet. Import formats

Tidy the file

1. Rename Parent issue to parent. Its value is the parent’s ID, which OpenTodo matches against the id column, so rename ID to id as well. Sub-issues become subtasks. Mapping rules
2. Convert Priority. Replace Urgent with 1, High with 2, Medium with 3, Low with 4, and clear No priority. CSV columns
3. Decide what Status becomes. Rename it section and your board has the same columns as Linear’s (Todo, In Progress, Done). Or add a completed column with yes on done issues and drop the status. You can do both. Sections
4. Delete Estimate, Cycle, Assignee and the other columns you do not need. Unknown columns are listed as ignored in the preview; Assignee is recognised as unsupported and dropped with a warning on each row. CSV columns

Import into OpenTodo

1. Open Settings → Data → Import data… and choose the file. Import from another app
2. In the preview, pick the target project for rows without one (a project per team works well), check the time zone, and read the row list: created, skipped with the reason, or error with the row number. Nothing is written yet. Import from another app
3. Select Import. The tasks reach every member’s devices once the project is shared. An import can be undone. Undo an import

Your first week

• Share each project with the team, editors for everyone, and assign the issues again. Assignees get a notification and an Assigned to me list. Share a project Assign tasks
• Switch the project to a board with v; the sections you imported are its columns. Turn a project into a board Switch to a board
• Cycles: a saved view #Launch & due <= 14 days pinned to the sidebar is the two-week window; a dashboard puts the team’s views side by side. Save a filter as a view Save your own views
• Scripts and automations: the REST API and the ot command line write to the same place as the app, and webhooks fire on changes. For developers HTTP API
• Where Linear stays ahead, the comparison says so; this page is not a reason to leave it. OpenTodo vs Linear