Skip to content

Tuskway for Linear

Linear tracks the work. Tuskway holds the thinking behind it.

Linear is where your team sees what is in progress. It is not where an AI agent learns how to build a ticket. Tuskway keeps the context, the tech design and a brief for each ticket, reviewed by your team. When the plan is ready you publish the tickets to Linear, and the two stay in step from then on.

What changes

What Linear gets from Tuskway.

  • Issues with a real brief

    Each issue is created from a ticket brief: a goal, acceptance checks, dependencies and the files to touch. The agent that picks it up reads the brief and the design section behind it, not a one-line title.

  • Two-way sync you can trust

    Status and assignee move in both directions. Tuskway adds its own labels and reads back the ones your team sets. When someone edits the issue in Linear, Tuskway flags the difference and lets you choose which version to keep. Nothing is overwritten silently.

  • Your workflow states

    A ticket's status maps to a workflow state your Linear team already has, matched by state type. In progress and in review both land on a started state, and Tuskway keeps the finer status on its side.

How it works

From a reviewed plan to Linear.

  1. 01

    A workspace owner connects Linear from the Trackers page and approves access in Linear.

  2. 02

    On an epic, pick the Linear team to publish to, and a project if you want one. Without one, Tuskway uses or creates a project named after the epic.

  3. 03

    Publish. Each ticket brief becomes a Linear issue, and the issue identifier is written back into the design index.

  4. 04

    Work as usual. Starting a ticket moves it to in progress, in Tuskway and in Linear. Opening the pull request moves it to review in Tuskway, and the Linear issue stays in a started state.

FAQ

Linear questions.

Does Tuskway replace Linear?

No. Linear stays the place where your team tracks work. Tuskway holds the plan behind the tickets and publishes them to Linear.

What happens if someone edits the issue in Linear?

Tuskway receives the change, shows it next to the ticket brief, and asks an editor which version to keep. The brief is never replaced without a decision.

Does Tuskway read our code through Linear?

No. The connection is used to list teams and projects, create and update issues, and receive issue changes. Your agents read your code where they already run.

Publish to Linear from a plan your team agreed on.

Connecting a tracker is optional. Tuskway never needs access to the code.