This article will cover everything you need to know to use Reclaim's Linear integration, which 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
You must have a Linear account and at least one team set up.
You must have a Reclaim account with a main calendar connected.
Setting up the integration for the first time
To get started with Linear, go to Settings -> Integrations. You'll see a list of integrations. Click "Connect Linear" on the Linear integration:
This will prompt you to log into Linear, and you'll see a screen asking you to give Reclaim a set of permissions. Once you provide those permissions, you'll be automatically redirected back to the integration's settings page.
Once you're on the settings page for the Linear integration, you'll see a couple of settings to customize how and when Reclaim syncs issues from your teams in Linear.
There are two main settings on this page:
Teams to add the integration to: Reclaim will automatically display the list of teams associated with your Linear account. You can select which teams should have the integration enabled.
How Reclaim syncs Linear issues: by default, Reclaim will sync any Linear issue that has an estimate associated with it, and that has a Cycle and/or due date. You can also opt to use the
Reclaimlabel in Linear to selectively sync only issues with that label on them.
Note: Reclaim will never sync any issues from Linear that don't have an estimate or a Cycle and/or due date.
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.
How Estimates affect scheduled tasks
Reclaim will automatically translate estimates on issues to task durations. Here is a chart showing the different estimation type in Linear, its value, and what the corresponding task duration is in Reclaim in hours:
You can change the estimate at any time for a Linear issue, and Reclaim will reduce the duration accordingly.
How due dates and Cycles affect scheduled tasks
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. 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.
How priority level affects scheduled tasks
Linear offers five priority levels for issues:
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 frontload your more important work. The higher the priority of an issue, the more aggressively Reclaim will try to defend the time.
How Reclaim sets different workflow states in Linear
Linear has several canonical workflow states for issues:
Here are a few notes about how workflow states affect synced issues:
In order for an issue to be synced to Reclaim, it cannot be in the Backlog state.
When a scheduled task associated with a Linear issue begins on your calendar, Reclaim will automatically move the issue into the Started state.
When an issue is moved to a Completed or Canceled state in Linear, it will automatically be deleted from Reclaim.
When a scheduled task is completed (i.e., all events associated with the task have been completed on the calendar or is marked as Done in Reclaim) Reclaim will not move it to Completed automatically.
If a task associated with a synced issue is canceled or deleted in Reclaim, it will not be moved to the Canceled state in Linear.