Linear Integration
Connect your Linear workspace to import issues, sync statuses, and manage work from Sunsama.
Bring your Linear issues into your daily plan. Browse My issues and your custom views in a panel beside your task list, drag in what you’ll work on today, and update the issue without leaving Sunsama.
Installation and account management
Go to Settings > Integrations > Linear, or open Linear in the right hand panel, and click Add Linear account. To connect another Linear account or workspace, click Add Linear account again.
The same settings page has an Include your activity from this tool in your Daily Highlights? toggle. To disconnect an account, click Remove next to it. If an account needs to sign in again, a Reconnect button appears beside it.
Browsing and importing issues
Open Linear in the right hand panel (keyboard shortcut Shift V), or search for Linear in the Command Palette (⌘ K).
Selecting your Linear account/workspace
If you’ve connected more than one Linear account or workspace, click the icon in the top right corner of the panel to pick one.
Browsing Linear views and issues
Click the view name at the top of the panel to switch views.
My issues view
My issues is the built-in view. Under Filter in the Display menu, choose Assigned, Created or Subscribed to see the issues assigned to you, created by you, or that you’re subscribed to. Completed issues stay visible for five days.
Custom views
Your Linear custom views and personal views are listed below My issues, with the same issues they show in Linear. To change what a view shows, edit it in Linear.
Display options
Click Display to change how the list looks:
- Hide: turn on Already imported (on by default) to hide issues you’ve already imported, or Done to hide completed issues.
- Sort by: Priority, Status, Due date or Identifier. Click the same option again to reverse the order, and a third time to clear it.
- Group by: Status, Priority, Project, Team or Cycle.
Importing issues
When you’re ready to work on a Linear issue, pull it into your plan:
- Drag the issue from the Linear panel onto your task list.
- To timebox it right away, switch to calendar view (
J) and drag the issue onto your calendar at the time you’ll work on it. Sunsama adds the task to that day and creates a working session on your calendar. - Click the issue and choose Add to today (or hover and press
S), or pick another date.
The issue’s Linear priority becomes the Sunsama task’s priority.
Add via URL
Already looking at the issue in Linear, or can’t find it in the panel? Copy its URL and paste it into a new task in Sunsama. You can also click Add by URL in the Display menu. See Add tasks via URL.
Interacting with imported issues
An imported Linear issue becomes a Sunsama task linked to the original. Click the Linear icon on the task (or hover and press G) to open it in Linear.
Editing the Linear issue from Sunsama
Click an issue in the panel, or open the imported Sunsama task, to see the Linear issue. Changes you make there are saved straight to Linear. You can:
- Change the status
- Add or remove labels
- Change the priority and the due date
- Edit the description
You can also see the project, what the issue is blocked by, its comments and its history. Comments are read-only in Sunsama.
The Sunsama task works like a worksheet for the Linear issue. Add notes, subtasks, time tracking and comments there without touching what your collaborators see in Linear.
Understanding synced fields
Sunsama doesn’t keep dates or completion in sync with Linear:
- Dates: the task shows on the day you planned it, its Sunsama start date. The Linear due date isn’t linked to any Sunsama date. Change it from the Linear preview inside the task.
- Completion: completing the task in Sunsama doesn’t change the Linear issue on its own. Turn on the status prompt (see Automations) to move the issue to a new status, like “Done”, as you complete it.
Keep Linear in sync via automations
Open the Linear panel in the right hand sidebar and click the Automations tab to control what Sunsama does when you import or complete a Linear issue.
Import automations
What actions should Sunsama take when you import a Linear issue?
- Show prompt to update status in Linear: asks you to pick a new status right after you import the issue, for example to move it from “Todo” to “In Progress”. On by default.
Completion automations
What actions should Sunsama take when you complete an imported issue?
- Show prompt to update status in Linear: asks you to pick a new status when you complete the task, for example “Done”. On by default.
Updating Linear issue status when adding via URL
When you add an issue by pasting its URL, you can also pick a new status for it before adding the task.
Task export to Linear
Export a task to Linear
Drag and drop a task into your Linear panel to export it. This removes the task from Sunsama and creates an issue assigned to you, with the title, notes, due date, and subtasks (as sub-issues) carried over. The issue is created in a team, so:
- When issues are grouped, the issue goes to the team of the group you drop it under, and takes that group’s status, project, cycle, or priority.
- Otherwise it goes to the team of the custom view you’re in, or to the only team your listed issues belong to.
- If Sunsama can’t tell which team to use (for example, My issues showing issues from several teams), the panel doesn’t accept drops. Group by status, project, cycle, team, or priority to choose where the issue goes.
Copy a task to Linear
Hold ⌘ (Mac) or Ctrl (Windows) while you drag to copy the task instead. The task stays in Sunsama, linked to the new Linear issue, and the issue has a link back to it.
To undo an export, press ⌘ Z (Mac) or Ctrl Z (Windows) within a minute. The first time you export, Sunsama also shows an Undo button.
Sunny and Autoplan
Sunny can read your Linear issues when you ask about them, for example “what’s assigned to me in Linear?”. Autoplan also looks at Linear when it drafts your day. To stop Autoplan from using Linear, open Integrations on the daily planning screen and turn Linear off.
Troubleshooting
A control in the Linear preview is locked
If a control in the Linear preview shows a lock, click it. When it says Sunsama needs more Linear access, click Grant access to approve the extra permission in Linear.