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

# Linear

> Create coverage requests from Linear issues

With our Linear integration, you can create coverage requests directly from your issue tracker.

## User flow

* In your Linear workspace, create a new issue or use an existing one
  * The title and description are used to create a prompt, and should cover the user scenario that needs to be tested
  * Attachments are also supported: e.g., images in the issue are provided to the agent
* Assign the issue to the **Empirical** agent
* This creates a request in Empirical
  * A link to the request is posted as a comment on the Linear issue
  * Empirical AI agents start working on the request right away
* Once the request is completed, the integration posts a status update back on the issue

## Routing to projects

If your organization has one project, all Linear issues are routed to it.

With multiple projects, map each Linear team to a project under **Settings → Requests → Project associations**. Issues are then routed by their team.

## Get started

To install the Linear integration:

<Steps>
  <Step title="Navigate to Integrations">
    Go to the **Integrations** page
  </Step>

  <Step title="Connect">
    Click **"Connect"** on the Linear integration
  </Step>

  <Step title="Accept permissions">
    Accept the permissions — the integration is configured instantly
  </Step>
</Steps>

## Permissions

The integration requests the following permissions:

| Scope           | Purpose                                                                          |
| --------------- | -------------------------------------------------------------------------------- |
| Create webhooks | Create a webhook that receives Linear events when the agent is assigned an issue |
| Read issues     | Get the contents of the issue, including title, description, and attachments     |
| Write comments  | Post comments with request links and status updates                              |
| Read user       | Get details of the user who assigned the issue                                   |