Linear

​

Capabilities

​

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

​

Using as a Deployment Trigger

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

​

Tool Examples

​

Create Bug Report

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

​

Find Related Issues

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

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

• customer-reported
• support-escalation
• documentation-needed

​

Set Up Issue Templates

• Bug report template
• Feature request template
• Support escalation template

​

Link Back to Conversations

• 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