Skip to main content

Cotool + Linear

Connect Linear to Cotool so you can @mention or assign security agents on issues, watch their progress stream in, and send detection output to Linear.

Ticketing & ITSM
Updated

The short answer

The Linear integration lets Cotool agents work inside Linear: you @mention or assign Cotool on an issue, the agent streams its thoughts, tool calls, and plan steps into the thread, and its final summary links back to the full run. Agents also create, search, and update issues, and detection agents can deliver output as Linear tickets.[1][2]

How it connects: Cotool installs as an app actor in your Linear workspace, so it can be assigned and mentioned. Linear apps request app-actor installation with the actor=app OAuth parameter, and agents installed in a workspace do not count as billable users.[1][3][4]

What Cotool uses from Linear

Issues and comments
Agents run full-text issue search with team, status, archive, and comment filters, list a team's issues, and read comments for ticket investigations.[2]
Agent Sessions
When Cotool is mentioned or assigned, Linear creates an Agent Session and sends Cotool a webhook. Follow-ups in the same thread continue the same Cotool conversation.[1][5]

Response actions

These change state in Linear, so they are the steps teams usually gate behind approval.

Manage issues
Agents create, update, and comment on issues, assign people, set priority, due dates, labels, and parents, handle duplicates, and attach files.[1][2]

Detections, hunts, and triage

Investigate from a Linear issueTriage
Mention Cotool with a request such as investigating a suspicious login from an IP, then follow up asking whether the IP appears in other alerts; the agent keeps the earlier context.[1]
Detections delivered to LinearDetection
Detection agents can use Linear ticket output destinations, so generated detections and their findings land directly in Linear.[2]

Setup and permissions

In Cotool's integration settings, connect Linear and approve the app installation. Earlier connections may need a reconnect to upgrade to app-actor credentials.[1]

PermissionAccess
app:assignableAllow the app to be assigned as a delegate on issues.[3]Write
app:mentionableAllow the app to be mentioned in issues, documents, and other editor surfaces.[3]Write
readDefault read access; Linear always includes it.[6]Read
writeWrite access, used to create and update issues and comments. Linear suggests narrower scopes when an app only creates comments.[6]Write
  • Linear expects an agent to acknowledge a new session within 10 seconds, or the session is marked unresponsive. Cotool answers immediately with a Thinking status.[1][5]
  • Agents cannot be added as project members or set as project leads, even with app:assignable.[3]

How Cotool works with Linear

  • One enabled Linear Agent Session trigger handles mentions and assignments for the organization. Without one, Cotool falls back to a personal chat for a user whose Linear email matches a Cotool account.[1]
  • You can stop a run from Linear: Cotool interrupts the agent, confirms in the thread, and marks the chat as interrupted.[1]

FAQ

Can an API call start a Linear agent session?
Yes. Cotool lets you start a Linear agent session with any agent through the API, and external automation can route sessions to any agent through the enabled trigger.[1][2]

Sources

  1. Linear integration (Cotool docs) · accessed November 16, 2026
  2. Changelog (Cotool docs) · accessed November 16, 2026
  3. Agents: getting started (Linear Developers) · accessed November 16, 2026
  4. OAuth actor authorization (Linear Developers) · accessed November 16, 2026
  5. Developing the agent interaction (Linear Developers) · accessed November 16, 2026
  6. OAuth 2.0 authentication (Linear Developers) · accessed November 16, 2026

Related integrations

All integrations

Use cases with Linear

Attackers are scaling with tokens

Cotool helps defenders operate at machine speed. See how security teams are scaling Detection & Response.

Book a demo