Linear

Keep tasks in sync between Hamster and Linear — changes flow both ways automatically.

Overview

The Linear connection links your Linear workspace to Hamster Studio. Tasks you create in a Hamster plan sync to Linear as issues, and status changes in either tool update the other within seconds. Hamster also reads your existing Linear issues, projects, and team structure, so it can reference your roadmap when writing briefs and generating plans.

Connect once from Settings, and everything stays in sync from there.

Two-Way Task Sync

When two-way sync is enabled, Hamster and Linear stay in lockstep:

  • Tasks you create in Hamster appear in Linear as issues. Title, description, status, priority, and assignee all carry over.
  • Status changes in Linear flow back to Hamster. Move an issue to "Done" in Linear and the Hamster task updates automatically.
  • Assignee changes sync in both directions. Hamster matches team members to Linear users automatically.
  • Priority updates propagate both ways. Set a task to "Urgent" in either tool and the other reflects it.

Two-way sync is available as an early-access feature. You can turn it on during connection setup or from the connection settings afterwards.

What Hamster Can Reference

Beyond two-way sync, Hamster reads your full Linear workspace:

  • Teams — Your Linear teams and how they're organized
  • Projects — Projects within each team, with status and progress
  • Issues — Issues and sub-issues, including titles, descriptions, status, priority, and labels
  • Comments — Comments on issues
  • Attachments — Files and links attached to issues
  • People — Workspace members and their profiles

Everything is indexed on connection and available to Hamster immediately.

How to Connect

  1. Go to Settings > Connections and click the Linear card.
  2. Click Connect with Linear.
  3. Sign in to Linear and authorize Hamster.
  4. Choose whether to enable two-way sync or connect for context only.
  5. If enabling two-way sync, select the Linear team and project to sync with.

The connection is named after your Linear workspace automatically.

Two-way sync requires admin or owner access in your Linear organization. If the person who connects has a lower role, the connection works for context only and the sync toggle is disabled.

Task Links

Tasks in Hamster that sync to Linear show a direct link to the corresponding Linear issue. Click the link on any synced task to jump straight to it in Linear. Linear issues created from Hamster plans link back to the originating brief.

Keeping Data Current

Your Linear context refreshes on connection. If your workspace changes significantly — new teams, restructured projects, a wave of new issues — open the connection card menu and select Quick Sync to pull in the latest data.

For two-way sync, task changes propagate automatically. No manual refresh needed.

Tips

  • You can connect one Linear workspace per team. Choose the one most relevant to the projects you run in Hamster.
  • Turn on two-way sync when you want Linear to be your team's execution view while Hamster handles planning. Tasks flow from brief to plan to Linear without manual copying.
  • Once connected, ask Hamster questions like "what are the open issues in the Onboarding project?" or "who is assigned to the highest-priority bugs?" — it pulls directly from your Linear data.
  • Linear works well alongside GitHub. Hamster can connect your issues to the code that addresses them when both are connected.

Related