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

# Linear

> Connect Linear to Steadwing so you can trigger AI-powered root cause analysis by assigning issues to the Steadwing bot or @mentioning Steadwing in any issue comment.

## What does the Linear integration do?

The Linear integration lets you trigger AI-powered root cause analysis directly from your Linear workspace -- just assign an issue to the Steadwing bot or @mention Steadwing in a comment. Steadwing automatically performs RCA, posts detailed findings and suggested fixes as threaded comments, and updates issue status so your team can resolve incidents without leaving Linear.

## Why Use Linear with Steadwing?

<CardGroup cols={2}>
  <Card title="Issue-Driven RCA" icon="list-check">
    Trigger root cause analysis by simply assigning issues to Steadwing
  </Card>

  <Card title="Comment-Based Analysis" icon="at-sign">
    Mention @Steadwing in any issue comment to get instant analysis
  </Card>

  <Card title="Threaded Updates" icon="messages-square">
    Receive detailed RCA results directly in Linear issue comments
  </Card>

  <Card title="Team-Wide Access" icon="users">
    Once installed by an admin, any workspace member can use Steadwing
  </Card>
</CardGroup>

## Benefits

* **Native Workflow Integration** - No need to switch between tools; manage incidents directly in Linear
* **Automatic Analysis** - Get instant RCA when issues are assigned or bot is mentioned
* **Collaborative Investigation** - Share insights and solutions with your team in Linear threads
* **Workspace-Wide Availability** - All team members can leverage Steadwing after initial setup
* **Real-Time Updates** - Track analysis progress with status updates in Linear

## How do I connect Linear to Steadwing?

### Connect Linear

1. Navigate to [Steadwing Integrations](https://app.steadwing.com)
2. Find the **Linear** integration card
3. Click the **Connect** toggle
4. You will be redirected to Linear's authorization page
5. Click **Authorize** to complete the connection
6. The Steadwing bot will automatically be installed in your Linear workspace

<Info>
  **Admin Setup, Team-Wide Use**: Once an admin installs the Linear integration, any member of your Linear workspace can assign issues to Steadwing or @mention the bot in comments. No additional setup required for team members!
</Info>

## How do I trigger RCA from Linear?

### Conversational Follow-up

After the RCA is completed, you can continue the conversation with Steadwing by tagging the bot in follow-up comments:

* Ask clarifying questions about the root cause
* Request additional details about suggested solutions
* Inquire about alternative approaches or fixes
* Get explanations about specific technical aspects

Simply @mention Steadwing in a new comment and ask your question. The bot will respond with context-aware answers based on the completed RCA.

**Example:**

```text theme={null}
Issue: API endpoint returning 500 errors
✅ Steadwing: RCA complete! Root cause: Database connection pool exhausted...
└─ Developer: @Steadwing What would be the impact of increasing the pool size to 100?
   └─ Steadwing: Increasing the pool size to 100 would help handle more concurrent requests...
```

### Delegation Flow: Assigning Issues

When you assign a Linear issue to Steadwing, here's what happens:

1. **Assignment** - You assign a Linear issue to the Steadwing bot
2. **Duplicate Check** - System checks if this issue is already being processed
3. **Issue Creation** - Creates a `LinearIssue` record with `PROCESSING` status
4. **Status Indicator** - Adds 👀 emoji reaction to indicate analysis is in progress
5. **RCA Execution** - Runs comprehensive root cause analysis
6. **Results Posted** - Posts detailed findings and solutions in Linear
7. **Status Update** - Updates issue status to `COMPLETED` or `FAILED` with ✅ or ❌ emoji

**Example:**

```text theme={null}
Issue: API endpoint returning 500 errors
Assigned to: Steadwing
👀 (RCA in progress...)
✅ └─ Steadwing: RCA complete!
      Root cause: Database connection pool exhausted due to missing timeout configuration
      Suggested fix: Add connection timeout in database config (pool.timeout = 30)
      [View full details](link)
```

### @Mention Flow: Comment-Based Analysis

When you @mention Steadwing in an issue comment:

1. **Mention Detection** - User @mentions the Steadwing bot in a comment
2. **Bot Filter** - Verifies the comment is not from the bot itself
3. **Duplicate Check** - Ensures this mention hasn't been processed already
4. **Placeholder Creation** - Creates a placeholder `LinearIssue` record
5. **Status Indicator** - Adds 👀 emoji reaction to indicate analysis is in progress
6. **RCA Execution** - Runs root cause analysis
7. **Threaded Results** - Posts detailed findings as a threaded reply
8. **Status Update** - Updates the LinearIssue status to `COMPLETED` or `FAILED` with ✅ or ❌ emoji

**Example:**

```text theme={null}
Issue: Memory leak in production worker
└─ Developer: @Steadwing can you investigate this memory leak?
   👀 (RCA in progress...)
   ✅ └─ Steadwing: Analysis complete!
         Root cause: EventEmitter listeners not being removed in worker cleanup
         Suggested fix: Add removeAllListeners() in worker shutdown handler
         [View full details](link)
```

## What permissions does the Linear integration need?

### Required Permissions

The Linear integration requires the following permissions:

* `read` - Read issues, projects, and workspace information
* `write` - Post comments and update issue status
* `comment:create` - Create comments on issues
* `issue:read` - Read issue details and metadata

### Workspace Access

Once installed by an admin:

* All workspace members can assign issues to Steadwing
* All workspace members can @mention Steadwing in comments
* No additional permissions or setup required per user
* Works across all projects in the workspace

### Issue States

Steadwing tracks the following states:

* `PROCESSING` - Analysis is in progress
* `COMPLETED` - Analysis finished successfully
* `FAILED` - Analysis encountered an error

## FAQs

<AccordionGroup>
  <Accordion title="Do all team members need to set up the integration?">
    No! Once an admin installs the Linear integration, any member of your Linear workspace can use it immediately. Team members can assign issues to Steadwing or @mention the bot without any additional setup.
  </Accordion>

  <Accordion title="What's the difference between assigning and @mentioning?">
    Assigning an issue creates a tracked incident in your Steadwing dashboard with full RCA, while @mentioning provides quick analysis in the comment thread. Both methods trigger the same analysis, but assignment offers more detailed tracking and historical data.
  </Accordion>

  <Accordion title="Can I use both assignment and @mention on the same issue?">
    Yes, but Steadwing will recognize duplicate requests and reference the existing analysis instead of running it twice.
  </Accordion>

  <Accordion title="What happens if the analysis fails?">
    Steadwing will post a comment in Linear explaining the failure and update the status to `FAILED`. You can view error details in the Steadwing dashboard or retry by @mentioning the bot again.
  </Accordion>

  <Accordion title="Can I cancel an ongoing analysis?">
    Currently, analyses cannot be cancelled once started. However, you can track progress in the Steadwing dashboard and receive updates in Linear as the analysis progresses.
  </Accordion>

  <Accordion title="Does Steadwing work with private Linear projects?">
    Yes, Steadwing works with all projects in your workspace, including private projects. The bot respects Linear's permission model.
  </Accordion>

  <Accordion title="How do I disconnect the Linear integration?">
    Go to [Settings](https://app.steadwing.com/settings), find the Linear integration, and click **Disconnect**. You should also remove the Steadwing bot from your Linear workspace settings.
  </Accordion>

  <Accordion title="Can I customize the analysis depth or focus?">
    Currently, Steadwing performs standard RCA. Future updates will support custom analysis parameters. You can provide context in the issue description or comments to guide the analysis.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)