Skip to main content
Connect Linear to let your agents create, update, and reference Linear issues.

​
Capabilities

CapabilitySupported
Knowledge Source✓ Search issues for context
Deployment Trigger✓ Respond to issue activity
Tool Actions✓ Create/update issues, add comments

​
Setup

​
Connect via OAuth

  1. Go to Settings → Connections in Duckie
  2. Find Linear and click Connect
  3. You’ll be redirected to Linear
  4. Authorize Duckie to access your workspace
  5. You’ll be redirected back to Duckie
Duckie requests read and write access to issues in your Linear workspace.

​
Using as a Deployment Trigger

Trigger agents based on Linear activity:
  1. Go to Deploy
  2. Click Create Deployment
  3. Select your agent
  4. Choose Linear as the trigger
  5. Configure events:
    • Issue created — When a new issue is filed
    • Issue updated — When an issue changes
    • Comment added — When someone comments

​
Available Tools

ToolDescription
linear_create_issueCreate a new issue
linear_update_issueUpdate issue fields
linear_add_commentAdd a comment
linear_get_issueGet issue details
linear_searchSearch issues

​
Tool Examples

​
Create Bug Report

In a runbook: 
When a customer reports a bug:
1. Use @linear_create_issue:
   - Team: Engineering
   - Title: Bug report from customer
   - Description: Include reproduction steps
   - Priority: Based on severity
   - Labels: ["bug", "customer-reported"]
2. Share the issue link with the customer

Before creating a new issue:
1. Use @linear_search to check for existing issues
2. If found, link to it instead of creating duplicate

​
Using as Knowledge Source

Index Linear issues for context:
  1. Go to Train → Knowledge
  2. Click Add Source
  3. Select Linear
  4. Choose which teams/projects to index
  5. Click Start Sync

​
Best Practices

​
Use Labels for Classification

Create labels for support-related issues:
  • customer-reported
  • support-escalation
  • documentation-needed

​
Set Up Issue Templates

Configure Linear templates that match your support workflow:
  • Bug report template
  • Feature request template
  • Support escalation template
Always include context when creating issues:
  • Link to support ticket
  • Customer information
  • Conversation summary

​
Troubleshooting

​
”Cannot access Linear”

  • Re-authenticate the connection
  • Verify your Linear account is active
  • Check workspace permissions

​
”Issue creation failed”

  • Verify the team exists
  • Check that required fields are provided
  • Ensure your account has create permissions