SOP-019: Linear Integration

Document Control

• Version: 1.0
• Last Updated: 2024
• Category: Integrations

---

Purpose

Connect Cursor with Linear to use Cloud Agents directly from Linear by delegating issues or mentioning @Cursor.

---

Scope

This SOP covers:

• Installing the Linear integration
• Delegating issues to Cursor
• Configuring repository mappings
• Using follow-up instructions

---

Prerequisites

• Linear workspace with admin access
• Cursor admin account
• GitHub connected to Cursor
• Usage-based pricing enabled

---

Procedure

Step 1: Connect Linear

1. Go to Cursor Integrations
2. Click Connect next to Linear
3. Select your Linear workspace and team
4. Click Authorize
5. Complete Cloud Agent setup:
   • Connect GitHub
   • Select default repository
   • Enable usage-based pricing

Step 2: Delegate Issues

Assign issues to Cursor for automatic processing:

1. Open a Linear issue
2. Click the assignee field
3. Select "Cursor"

Cursor analyzes the issue and starts a Cloud Agent.

Step 3: Use @Cursor Mentions

Mention Cursor in comments:

@Cursor fix the authentication bug described above

This works for:

• Adding context to an issue
• Providing follow-up instructions
• Starting new agents on existing issues

Step 4: Configure Repository Mapping

Cursor determines which repository to use in this order:

1. Issue text: [repo=owner/repository] in description/comments
2. Issue labels: Repository labels on the issue
3. Project labels: Repository labels on the project
4. Default: Dashboard default repository

Setting Up Repository Labels:

1. Go to Linear Settings > Labels
2. Click New group
3. Name the group "repo" (exactly)
4. Create labels for each repository: owner/repo

Step 5: Monitor Progress

Track agent status:

• Linear Activity: Real-time status updates
• Cursor Dashboard: Cloud Agents tab
• PR Creation: Automatic when agent completes

Step 6: Provide Follow-up Instructions

Reply in the agent session:

@Cursor also add error handling for edge cases

---

Configuration Options

Use [key=value] syntax in issue text:

Option	Example	Description
repo	[repo=org/repo]	Target repository
branch	[branch=develop]	Base branch
model	[model=claude-sonnet]	AI model

---

Dashboard Settings

Configure defaults at Cloud Agents Dashboard:

Setting	Description
Default Repository	Primary repo when not specified
Default Model	AI model for agents
Base Branch	Branch for PR creation

---

Verification Checklist

• [ ] Linear integration connected
• [ ] Account linking completed
• [ ] Default repository configured
• [ ] Test delegation works
• [ ] PR created successfully

---

Troubleshooting

Issue	Solution
Agent not starting	Check issue is development work
Wrong repository	Add repo label or use [repo=...]
Account not linked	Complete first-use linking flow
No PR created	Check GitHub integration status

---

See Also

• SOP-017: GitHub Integration
• SOP-021: Cloud Agents