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

New Linear connections start with two-way sync disabled by default. This gives teams a safe setup path: connect for context first, then explicitly enable task syncing when you are ready.

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

Go to Settings > Connections and click the Linear card.
Click Connect with Linear.
Sign in to Linear and authorize Hamster.
Choose whether to enable two-way sync or connect for context only.
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.

Tag-Based Project Filtering

You can control which Linear projects sync to Hamster by tagging them. Instead of syncing everything, add a specific tag in Linear and configure Hamster to only sync projects with that tag.

This is useful when your Linear workspace contains projects from multiple teams or initiatives and you only want a subset flowing into Hamster.

To configure:

Open the Linear connection settings in Settings > Connections.
Under Sync Settings, enable tag-based filtering.
Enter the tag name to filter by.

Only projects with the matching tag are synced. New projects tagged later are picked up automatically during the next sync cycle.

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.