Tickets Tab

The Tickets tab lets you browse your Linear workspace from inside BuildBetter. Use it to bring Linear-tracked work into the BuildBetter projects flow — bulk-promote tickets, auto-attaching each to a new project.

Filter Controls

The tab fetches Linear metadata on demand. Available filters:

• Team — every team in your Linear workspace
• Project — projects within the selected team
• State — issue states for the selected team
• Assignee — issue assignee

Free-text search routes through Linear's relevance search on the backend, so it understands the same query syntax Linear does.

Issue Rows

Each row shows:

• Identifier — Linear-style ID (e.g., ENG-123)
• Title
• State — colored chip matching Linear
• Priority
• Assignee avatar
• Updated at — relative timestamp

Clicking a row opens the issue in Linear (new tab). There's no internal detail pane for tickets — Linear is the source of truth.

Bulk Promote

The headline action. Select multiple Linear tickets, then click Promote N. The system:

1. Creates one tracked item per ticket
2. Auto-attaches the Linear ticket to the tracked item
3. Promotes the tracked item to /projects
4. Skips any ticket that's already linked to a project — surfacing a toast: "Already linked to project X"

This is the fastest way to backfill Linear work into BuildBetter projects — useful when you're onboarding a team that already lives in Linear.

Filtering Out Already-Linked Tickets

The endpoint auto-filters tickets that already have a BuildBetter project link, so you won't see duplicates in the list. If you specifically want to re-link or re-promote, do it from the individual tracked item in the Signals tab.

Tip: If a Linear ticket and a BuildBetter project share the same intent but were created separately, you can attach the ticket to the existing project from the project's Integration Issues card — no need to re-create the project.