Skip to main content

​
Overview

The Linear integration enables seamless incident management directly from your Linear workspace. When issues are assigned to Steadwing or the bot is mentioned in comments, it automatically performs root cause analysis and provides detailed insights and solutions without leaving Linear.

​
Why Use Linear with Steadwing?

Issue-Driven RCA

Trigger root cause analysis by simply assigning issues to Steadwing

Comment-Based Analysis

Mention @Steadwing in any issue comment to get instant analysis

Threaded Updates

Receive detailed RCA results directly in Linear issue comments

Team-Wide Access

Once installed by an admin, any workspace member can use Steadwing

​
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

​
Setup Instructions

​
Connect Linear

  1. Navigate to Steadwing Integrations
  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

​
Verify Installation

  1. Go to any Linear issue
  2. Click on the assignee field
  3. You should see Steadwing appear in the list of available team members
  4. Check that you can @mention the bot in issue comments
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!

​
How Linear Integration Works

​
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: 
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: 
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: 
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)

​
Configuration

​
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

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.
Assigning creates a tracked incident in your Steadwing dashboard with full RCA, while @mentioning provides quick analysis in the comment thread. Both trigger the same analysis, but assignment offers more detailed tracking and historical data.
Yes, but Steadwing will recognize duplicate requests and reference the existing analysis instead of running it twice.
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.
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.
Yes, Steadwing works with all projects in your workspace, including private projects. The bot respects Linear’s permission model.
Go to Settings, find the Linear integration, and click Disconnect. You should also remove the Steadwing bot from your Linear workspace settings.
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.
Need additional help? Please reach out to us at [email protected]