> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duckie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Connect Linear to manage issues and projects with Duckie

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

## Capabilities

| Capability             | Supported                            |
| ---------------------- | ------------------------------------ |
| **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

<Info>
  Duckie requests read and write access to issues in your Linear workspace.
</Info>

## 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

| Tool                  | Description         |
| --------------------- | ------------------- |
| `linear_create_issue` | Create a new issue  |
| `linear_update_issue` | Update issue fields |
| `linear_add_comment`  | Add a comment       |
| `linear_get_issue`    | Get issue details   |
| `linear_search`       | Search 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
```

### 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

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

### Link Back to Conversations

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