Add Linear to Tweek

Connect Linear and the issues assigned to you show up in Tweek, in their own list, so you can plan them into your week next to everything else. The sync reads your tracker and never writes to it — what you do in Tweek stays in Tweek.

Set it up

Linear is a Premium feature, connected from the web app. On a calendar you share with someone, it is the owner who connects it.

1. Open Settings and pick the calendar you want the issues in.
2. In Synchronization, switch Linear on.
3. Linear asks you to allow access. It shows exactly one permission: read access to your workspace.

Tweek then creates a list called Linear in your Someday section, first in the row, and brings in the issues assigned to you. After that the list refreshes every 5 minutes, and the Sync now row in the Linear settings runs an import at once when you do not want to wait. The first import takes a few seconds; if Linear is slow, it carries on in the background — you can close the window and the issues turn up in the list on their own.

One workspace at a time. Whichever workspace you pick on Linear’s consent screen is the one that syncs, and its name is shown under the Linear row in settings. To switch, disconnect and connect again.

Which issues arrive

Only the issues assigned to you, and only those sitting in a Todo or In Progress status. Backlog, triage, done and canceled issues stay in Linear — otherwise a busy tracker would flood the list with hundreds of rows nobody plans. Up to 100 issues at a time, most recently updated first.

A task reads ENG-123 Fix the login screen, and its note holds a link straight back to the issue plus the beginning of the description. A due date in Linear does not place the task on a day: everything lands in the list, and you decide when to do it.

The Linear list

The list is yours to keep. Rename it to anything you like — it is matched by its id and not by its name, so the issues keep landing in it. Tasks of your own can sit in it too: the sync only ever touches the ones it imported.

Delete the list and Tweek puts it back at the next refresh, with the issues still assigned to you — the integration needs somewhere to file them. To stop them arriving, disconnect Linear.

Color by status

Switch Color by status on in the Linear settings and every imported task takes the color of the status its issue is in. The two groups — Not started and In progress — take a color each, and any single status of your workspace can be given one of its own on top of that: review in lilac while the rest of In progress stays yellow.

A task you tick off drops the status color and looks like any other finished task. Switch the setting off and Tweek takes back the colors it painted, leaving the ones you chose yourself alone.

Issues you have started

Switch Move In progress issues to Today on and an issue that moves into an In progress status in Linear is planned straight into today instead of waiting in the list — so the list never holds something you are already working on.

Only a task still sitting untouched in the list is moved. One you had already pulled into a day, filed under a list of your own or ticked off stays where you put it: the switch gives an issue a starting point, it does not follow it around your week.

Both switches start off, so an integration connected before they existed keeps the list it had.

What happens as things change

• An issue is assigned to you — it appears in the Linear list within 5 minutes.
• It is unassigned, or somebody else takes it over — the task goes, and not only out of the list: a day you had already planned it into loses it too, because the issue is no longer yours to plan. The same happens if the issue is deleted in Linear, or you lose access to it.
• It is moved to the backlog — it leaves the list, but a day you had planned it into keeps it: the issue is still yours, only postponed.
• It is finished or canceled in Linear — the task is ticked off in Tweek and stays exactly where you put it, so you can still see what you got done. A task you have ticked off is never taken away from you afterwards, whatever becomes of the issue.
• It comes back to Todo — it is in the list again.
• Its title or description changes in Linear — the task is updated to match at the next refresh. Linear owns the text.

Editing the task in Tweek

Tweek owns where the task sits — which day, in what order. Once you pull a task into a day, the sync never moves it again. It can still take the task away, though, if the issue stops being yours: see what happens as things change.

You can rename an imported task, and your wording stays until the issue itself changes in Linear — at that point the title is refreshed from Linear and your edit is replaced. For a note that has to survive, use a subtask or a task of your own.

Nothing travels back to Linear

The integration is read-only in this version:

• ticking a task off in Tweek does not close the issue;
• renaming it does not rename the issue;
• deleting it removes it from Tweek only — and it will not come back, even though the issue is still assigned to you.

Status, assignee and comments stay in Linear, where your team sees them.

If the list stops updating

Tweek’s access can end without you touching anything in Tweek — the app is removed in Linear, or your workspace withdraws its approval. The sync then stops, the Linear row switches itself off, and the settings ask you to reconnect.

Nothing is lost while it is off: the list and every task in it stay exactly where they are. Switch the row back on, allow access again, and the same list carries on — the tasks you had already planned into your week included, issue links and all.

Disconnecting

Switch the Linear row off and Tweek asks you to confirm, telling you how many unfinished Linear tasks it is about to delete. Those go for good — wherever you had put them, the list or a day you had planned them into, and with their dates, subtasks, files and notes. This cannot be undone.

Tasks you have ticked off stay, as ordinary Tweek tasks with nothing left to do with Linear. The Linear list is removed once it is empty; if you had filed tasks of your own in it, the list stays with your tasks in it.

Nothing changes on the Linear side. You can also revoke Tweek’s access from Linear itself, under third-party applications in your workspace settings.

If your workspace needs approval

Some Linear workspaces require an owner to approve new applications. If yours does, the connection will not go through and Tweek says so — request approval in Linear, then connect again once Tweek is allowed.