Skip to main content

​
Linear Integration

Overcut connects to Linear so your agents can open, update, and comment on issues without leaving the workflow. After you authorize the connection, Linear teams appear alongside your existing ticket providers, letting you automate planning and status updates across every tool your organisation uses.

​
Overview

With Linear connected you can:
  • Create issues from detections, check-ins, or any trigger in your workflow
  • Update titles, descriptions, labels, and assignees as work progresses
  • Synchronise labels between Overcut and Linear to ensure workflows can filter and route tickets accurately
  • Reference Linear issues in end-to-end workflow recipes that combine code, data, and planning tasks

​
Connecting Linear

1

Choose Linear

In Overcut, open Integrations, select Add Provider, then select Linear. Linear opens in a browser popup.
2

Approve access in the popup

Review the request and approve Overcut’s access to your Linear workspace. Overcut confirms the connection and lists the workspace under Integrations.
3

Select Linear teams

Open the connected workspace, select Add Teams, choose the teams you want to use, then select Add Selected Teams. Each selected team becomes a ticket repository you can reference in triggers and actions.
To connect another Linear workspace, select Add Provider and choose Linear again. Adding a workspace is separate from adding more teams from a workspace that is already connected. For popup and confirmation details shared by all providers, see Connect a provider.

​
Provider-Specific Behaviors

  • Team as Repository: Each Linear team you select is treated as a separate ticket repository. You can target specific teams in triggers and actions just like you would with GitHub or Jira projects.
  • Status names: Issue trigger filters (such as Status From and Status To) use the exact workflow status names configured for the selected team (for example, Triage, Backlog, In Progress, Done). Names differ by team. Linear provides the destination status but not the previous status, so Status To filters work reliably while Status From will not match.
  • Linked issue relationships: Agents can create, remove, and read linked issue relationships in Linear. Linear uses its own relationship names (agents can inspect the available types before linking). See the tools reference for how linked relationships work across providers.

​
Automations and Agent Workflows

Once connected, Linear issues become a first-class citizen inside the Overcut workflow builder. Agents can create, update, and comment on issues the same way they already interact with GitHub or Jira.

Create an Issue

Generate a new Linear issue from any trigger such as a failing test, Sentry alert, or Slack slash command.

Update an Issue

Edit titles, descriptions, labels, or assignees as your workflow progresses and new context emerges.

Close & Resolve

Mark issues as Done or Canceled when a pipeline finishes successfully or when a rollback is triggered.

​
Next Steps