Skip to main content

Linear Integration

Why Connect Linear?

Samepage helps Product Managers track engineering progress and shipping velocity without constantly checking boards. By connecting Linear, Samepage users can:

  • Build Signals to summarize what shipped, what's in progress, and what's blocked

  • Track cycle progress and team velocity across projects

  • Surface stalled issues and missed deadlines before standup

  • Use the Samepage Copilot to answer questions or draft documents informed by Linear data

Integration Type

Shared integration — one admin connects Linear, and the data is available to all users in the workspace.

Data Imported

Samepage views and imports the following from Linear:

  • Issues — Tickets across all projects, including title, description, and priority

  • Status changes — Workflow state transitions and current status

  • Labels — Issue labels and categories

  • Comments — Discussion threads on issues

  • Assignments — Assignee information

  • Projects — Project metadata, status, and milestones

  • Teams — Team structure and membership

  • Users — Team member profiles

  • Cycles — Cycle dates, scope, and issue membership

This data is used to help Product Managers monitor engineering execution, track what shipped, and identify blockers early.

Sync Behavior

  • Initial sync pulls issues from the last 3 months

  • Ongoing syncs pull issues updated in the last 1 week

How to Connect

  1. You must have an existing Samepage account. If you need one, sign up at samepage.ai.

  2. Go to the Integrations page in Samepage.

  3. Find and click Linear.

  4. Authenticate your Linear account and accept the requested permissions.

  5. Samepage will begin importing data from Linear automatically, refreshing multiple times per day.

What You Can Do After Connecting

  • Create Signals that analyze Linear issues — e.g., "Summarize recent issues" or "What shipped this week across all teams?"

  • Chat with Copilot about Linear data — e.g., "What's the status of the notifications project?" or "Which issues are blocked right now?"

  • Combine with other data — Cross-reference Linear issues with Slack discussions, customer feedback from Intercom, or meeting notes from Zoom for a complete picture

Signal Examples Using Linear

Signal

What It Does

Weekly Engineering Progress

Summarizes what shipped, what moved to in progress, and what's blocked across teams

Cycle Health Report

Tracks completion rate for the current cycle and flags issues at risk of slipping

Blocked Issue Tracker

Surfaces issues marked as blocked or stalled with no recent updates

Cross-Team Shipping Log

Rolls up completed issues across all teams into a single weekly shipping summary

Example Signal Prompt

Here's a detailed prompt you can paste into a Signal's instructions field to get a weekly engineering progress report:

Review all Linear issues updated in the past week and produce a structured progress report organized as follows:

Shipped — List all issues that moved to "Done" or "Completed" this week. Group by team or project. Include the issue title, assignee, and a link to the Linear issue.

In Progress — List issues currently in an active working state. Note how long each has been in progress. Flag anything that's been in progress for more than 5 days.

Blocked — Surface any issues that are marked as blocked, have a "blocked" label, or mention being blocked in comments. Note what's blocking them and who owns the resolution.

Cycle Progress — For each active cycle, summarize the completion percentage — how many issues are done vs. remaining. Flag any cycle that looks at risk of not completing on time.

Key Takeaways — Provide 3-5 bullet points summarizing the overall engineering momentum this week. Call out any patterns — e.g., a team that shipped a lot, a project that's stalling, or a spike in new issues.

Keep it concise. Use bullet points. Include links to Linear issues wherever possible so I can jump to the source.

FAQ

Does this integration provide clickable links back to the source? Yes. Linear issues include deep links that take you directly to the issue in Linear. When Signals or Copilot reference an issue, you can click through to view the full ticket in Linear itself.

Privacy

Linear data is never used to train AI models. Data is processed only to generate Signal outputs and Copilot responses. See Data Handling for more information.

Did this answer your question?