Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt

Use this file to discover all available pages before exploring further.

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