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

# Linear

> Connect Linear to Clarion so agents can create issues authored by the Clarion app, not by a person on your team.

This guide shows how to connect Linear to Clarion. Once connected, Clarion agents can create issues during triage. Issues are authored by **Clarion** in Linear, so they appear separate from any human team member's account.

> **Note:** **Estimated time:** 2 minutes. You need access to:
>
> * A Clarion workspace\*\* with permission to manage integrations
> * A Linear workspace\*\* with permission to authorize OAuth applications

## Prerequisites

* A Linear account with permission to install OAuth applications in your Linear workspace
* At least one Linear team where Clarion should create issues

***

## Step 1 - Connect Linear

1. In Clarion, open **Integrations** and find **Linear**.
2. Click **Connect Linear**. You'll be redirected to Linear to authorize Clarion.
3. Review the requested permissions in Linear, then click **Authorize**.

Linear redirects you back to Clarion with the integration connected.

> **Info:** Issues Clarion creates will be authored by the Clarion app in Linear, not by you personally. Linear shows the Clarion app icon next to each issue Clarion creates.

***

## Step 2 - Choose a default team (optional)

After connecting, you can pick a **default team** in the Linear integration page. When an agent creates an issue without specifying a team, Clarion uses the default. Without a default, agents must always pass an explicit team.

***

## What Clarion can do

After connecting Linear, agents can:

* **Create issues** with a title, description, and optional priority
* **Choose the Linear team** for each issue, or use the default

Clarion does not currently read or update existing issues - issue creation is one-way from Clarion to Linear.

***

## Disconnect Linear

To disconnect:

1. Open the **Linear** integration in Clarion.
2. Click **Disconnect**.
3. Confirm the dialog.

Clarion revokes its Linear access token immediately. Issues Clarion previously created remain in Linear unchanged.