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 15 minutes. 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.

What happens as things change

• An issue is assigned to you — it appears in the Linear list within 15 minutes.
• It is unassigned, or moved to the backlog — it leaves the list. If you had already moved it into a day, it stays there as an ordinary Tweek task: a week you have planned is never emptied for you.
• 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.
• 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 leaves its placement alone.

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. The Linear list is removed, together with the imported issues still sitting in it. Tasks you had already moved into your week stay as ordinary tasks, no longer linked to Linear. If you had filed tasks of your own in that list, the list stays too, with your tasks in it — only the imported issues go.

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.