How does the Linear integration work?

Connect Linear and the issues assigned to you show up in Tweek, in their own list, ready to plan into your week. It is a Premium feature: open Settings → your calendar → Synchronization and switch Linear on — on a calendar you share with someone, the owner is the one who connects it. Linear asks for one permission — read access to your workspace.

Tweek creates a list called Linear in your Someday section and keeps it up to date every 5 minutes; Sync now in the Linear settings runs an import at once when you do not want to wait. Only the issues assigned to you arrive, and only those in a Todo or In Progress status. The first import takes a few seconds; if it takes longer you can close the window — it carries on in the background and the issues turn up on their own. Drag them into a day when you plan — the sync never moves them back.

Two switches sit in the same settings, both off until you turn them on. Color by status paints every imported task with the color of the status its issue is in — a color for Not started and one for In progress, and any single status of your workspace can be given one of its own. A task you tick off drops the status color, and switching the setting off takes back the colors Tweek painted. Move In progress issues to Today puts an issue straight into today as soon as it moves into an In progress status in Linear, instead of leaving it in the list; a task you had already placed yourself stays where you put it.

Nothing travels the other way: ticking a task off in Tweek does not close the issue, and renaming or deleting it changes nothing in Linear. When an issue is finished there, the task is ticked off here and stays where you put it. When it is unassigned, taken over by somebody else or deleted in Linear, the task goes — out of the list, and out of a day you had already planned it into: the issue is no longer yours to plan. An issue only moved to the backlog is still yours — it leaves the list, but a day you had planned it into keeps it.

The list is yours to keep: rename it to anything you like and the issues keep landing in it, and your own tasks can sit in it too. If the Linear row switches itself off and asks you to reconnect, Tweek’s access ended on the Linear side — switch it back on and allow access again. Nothing is lost in the meantime: the list and the tasks in it stay where they are, and the same list carries on.

Disconnecting asks you to confirm and tells you how many unfinished Linear tasks it is about to delete. Those are removed for good, wherever you had put them — the list, or a day you had planned them into — together with their dates, subtasks, files and notes. Tasks you have ticked off stay, as ordinary Tweek tasks. The Linear list itself is removed once it is empty; if you had filed tasks of your own in it, the list stays with your tasks in it.

The full picture — every case of an issue changing, being reassigned or reopened — is in the Linear documentation.