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.
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]
Response actions
These change state in Linear, so they are the steps teams usually gate behind approval.
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]
| Permission | Access | Why |
|---|---|---|
app:assignableAllow the app to be assigned as a delegate on issues.[3] | Write | Allow the app to be assigned as a delegate on issues.[3] |
app:mentionableAllow the app to be mentioned in issues, documents, and other editor surfaces.[3] | Write | Allow the app to be mentioned in issues, documents, and other editor surfaces.[3] |
readDefault read access; Linear always includes it.[6] | Read | Default read access; Linear always includes it.[6] |
writeWrite access, used to create and update issues and comments. Linear suggests narrower scopes when an app only creates comments.[6] | Write | Write access, used to create and update issues and comments. Linear suggests narrower scopes when an app only creates comments.[6] |
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
Sources
- Linear integration (Cotool docs) · accessed November 16, 2026
- Changelog (Cotool docs) · accessed November 16, 2026
- Agents: getting started (Linear Developers) · accessed November 16, 2026
- OAuth actor authorization (Linear Developers) · accessed November 16, 2026
- Developing the agent interaction (Linear Developers) · accessed November 16, 2026
- OAuth 2.0 authentication (Linear Developers) · accessed November 16, 2026
