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

Open Integrations

In Overcut, navigate to Settings → Integrations and click Connect Linear.
2

Authorize Overcut in Linear

Overcut redirects you to Linear’s authorization screen. Review the requested scopes and click Authorize. Overcut needs permission to read and write issues, comments, and labels so agents can operate on your behalf.
3

Map Linear Teams (optional)

After authorization, choose which Linear teams should appear as Ticket Repositories in Overcut. Each selected team becomes a repository you can reference in triggers and actions.
4

Finish Setup

Click Save & Finish. Connected teams are now visible under Repositories → Tickets and available in workflow builders.

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

​
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—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