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

# Linear

> Connect Missio with Linear to automate project management and issue tracking

## Overview

The Linear integration enables both the Missio Agent and Co-Pilot to manage issues, track projects, and coordinate development work while maintaining context from conversations across all your integrated platforms.

## Available Tools

### Agent Capabilities

<Info>
  The Missio Agent can autonomously monitor and manage Linear issues based on
  configured rules and detected patterns.
</Info>

**Issue Management:**

* Create new issues
* Update existing issues
* Manage issue status
* Set priorities
* Assign team members
* Add labels and tags
* Track cycle progress
* Link related issues

**Automation Rules:**

* Auto-create issues from conversations
* Auto-assign based on context
* Auto-set priorities
* Auto-update status
* Auto-link related items
* Sync updates across platforms
* Schedule status checks
* Create recurring tasks

### Co-Pilot Commands

<Info>
  Use natural language commands in the Co-Pilot to manage your Linear workspace
  directly from Missio.
</Info>

**Linear Actions:**

# Issue Management

"Create a new bug report for the authentication error"
"Assign the API integration task to Sarah"
"Move all high-priority issues to In Progress"

# Project Organization

"Show all issues in the current sprint"
"Create a new project for Q4 features"
"List all bugs assigned to the backend team"

# Status Updates

"Update status of AUTH-123 to Done"
"Mark all documentation tasks as Ready"
"Show blocked issues in the current cycle"

# Cross-Platform Actions

"Create an issue from this Slack thread"
"Schedule a review meeting for this feature"
"Link this issue to the related GitHub PR"

## Sample Workflows

### 1. Bug Management

When: Bug report comes in through Slack/Discord
Agent will:

1. Create Linear issue with appropriate labels
2. Set priority based on impact
3. Assign to relevant team
4. Link conversation thread
5. Notify team in Slack

### 2. Feature Request Tracking

When: Feature request is detected
Agent will:

1. Create feature request issue
2. Add to backlog/triage cycle
3. Tag product team
4. Create initial scope document
5. Schedule triage review

### 3. Sprint Management

When: Using Co-Pilot
You can say:
"Manage sprint by:

* Moving completed issues to Done
* Updating remaining estimates
* Identifying blocked items
* Preparing for sprint planning"

## Setup Instructions

1. Go to Missio Settings → Integrations
2. Select "Linear" from project management providers
3. Complete OAuth authentication
4. Configure Agent rules and Co-Pilot preferences

<Note>
  The Linear integration requires specific permissions to manage issues and
  access team information. Review the permissions carefully during setup.
</Note>

## Best Practices

* Set up clear issue templates
* Configure workflow automations
* Use consistent labeling
* Maintain organized project hierarchy
* Regular backlog grooming
* Set up team-specific views

## Limitations

* API rate limits apply
* Some features require Linear Team/Enterprise plans
* Custom field limitations may apply
* Workflow automation rules follow Linear constraints
* Historical data sync restrictions

Need help? Contact our support team or visit our [community forum](https://discord.gg/9CwnRH2Bgt).
