Linear integration overview

How to use Reclaim's Linear integration to automatically sync issues from Linear to scheduled Tasks in Reclaim.

Updated over a week ago

Reclaim's Linear integration automatically syncs issues created in Linear to scheduled Tasks in Reclaim. It's a great way to make sure that you actually get time blocked in your calendar for the issues assigned to you in Linear.

Requirements for using the integration

  • A Linear account and with at least workspace set up.

  • A Reclaim account.

  • Enable Estimates and Cycles for the workspace you want the integration turned on for.

Note: Currently, there isn't a way to support multiple workspaces for a Linear account. Linear's authentication connect flow and API don't involve a multi-workspace concept, so when you connect Reclaim, you'll be connected to whatever workspace you currently have selected in Linear.

Install the Linear integration

  1. Find the card for the Linear integration.

  2. Click Connect Linear.

  3. You will be prompted to log into Linear and give Reclaim access to a set of permissions.

  4. Once you provide those permissions, you will be redirected back to the Reclaim Integrations page.

How due dates, cycles, and priority levels in Linear affects scheduled Tasks

Due dates and cycles

In addition to requiring an estimate for Linear issues, any synced issue needs to have either a due date or belong to a Cycle in Linear, unless specified otherwise by you as described below. Reclaim will use the due date or the Cycle end date to determine the due date of the scheduled task.

If there is both a due date and a Cycle for an issue, Reclaim will use the earlier of the two.

The Linear integration allows you to decide whether or not you want to allow Linear issues to be synced that don't have due dates.

  • If you select Sync Linear tasks without due dates, then tasks will be synced whether or not the task has a a due date or Cycle end date in Linear.

  • If you select Don't sync Linear tasks without due dates, then a due date or Cycle end date is required for any task synced from Linear.

Priority levels

Linear offers five priority levels for issues:

  • No Priority

  • Low

  • Medium

  • High

  • Urgent

For issues synced to Reclaim that are within a Cycle in Linear, Reclaim will set the due date differently based on the priority level of the issue to help front load your more important work. The higher the priority of an issue, the more aggressively Reclaim will try to defend the time.

Additionally, Reclaim will automatically sync and map priority levels from Linear to priority levels in Reclaim:

Linear

Urgent
High
Medium
Low

Critical (P1)
High priority (P2)
Medium priority (P3)
Low priority (P4)

Linear tasks will need a priority in able to sync to Reclaim.

How Reclaim tasks display in synced Linear issues

If you selected the option to automatically sync all issues in Linear with an estimate + a Cycle and/or due date, Reclaim will start syncing them immediately. However, if you selected the option to only sync issues containing the Reclaim label, those issues will only sync if you add the label to them.

Any issue that has been synced as a Task in Reclaim will look like this:

The Reclaim link on synced Linear issues will contain a bit of info about the task's status as well as when it's scheduled, and clicking on it will take to the edit screen for the task in the Reclaim UI.

Did this answer your question?