Linear integration

Linear connects to Cooperly in two ways: Linear Agent can use read-only team and member context, and Cooperly can sync roadmaps into managed Linear projects, milestones, and issues.

Use Linear Agent with read-only Cooperly context, plus one-way roadmap sync into managed Linear projects, milestones, and issues.

Why teams connect Linear

Linear is where many product and engineering teams plan delivery. Cooperly makes that work better by bringing live team context into the planning surface and by syncing the Cooperly roadmap into a managed Linear shape.

The integration deliberately separates agent context from project sync. Linear Agent can ask Cooperly for read-only team and member context, while Linear Projects sync writes only managed projects, milestones, and issues.

What the integration does

For Linear Agent, Cooperly exposes read-only team, member, candidate, and delivery-risk context for issue writing, owner suggestions, comments, and delivery risk checks. Linear owns Linear-side agent actions.

For roadmap sync, Cooperly can create and update one managed Linear project per mapped Cooperly team, with milestones by horizon and issues by roadmap item. Sync is one-way, does not delete manual Linear work, and can keep Pulse or Fundamentals evidence out unless a team explicitly enables it.

  • Map each Cooperly team to one Linear team.
  • Optionally add a Linear Initiative rollup when the connection has the required scope.
  • Treat evidence visibility as a Linear-team visibility decision, especially for public Linear teams.

Why it matters

Linear stays the delivery system. Cooperly supplies the people context and managed roadmap source that help Linear work reflect real team ownership, risk, and follow-up.

Configure

  1. 01

    Enable Linear access in Cooperly

    Turn on Linear for the account, then grant only the Cooperly teams Linear Agent or Linear Projects should use.

  2. 02

    Connect the Linear workspace

    Use the Cooperly Linear app, or the personal API key fallback, so Cooperly can read Linear teams and create managed roadmap projects.

  3. 03

    Map Cooperly teams to Linear teams

    Choose one Linear team per Cooperly team, then decide whether roadmap sync, initiative rollup, and evidence in issue descriptions should be enabled.

  4. 04

    Add Cooperly to Linear Agent

    In Linear Agent personalization, add Cooperly as a custom MCP server, complete Cooperly sign-in, and keep the agent path read-only.

  5. 05

    Use the right boundary

    Linear Agent uses Cooperly only for context; Linear Projects sync creates and updates managed Linear work without deleting manual Linear work.