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

# Linear

> Connect Linear tickets to Ref Plans for context and status updates.

The Linear integration lets you attach Linear tickets to your plans for context and have agents update ticket status based on progress.

## Connect Linear

1. Go to **Settings** in Ref Plans
2. Click the **Integrations** tab
3. Select **Linear**
4. Enter your Linear API key
5. Click **Test Connection** to verify

## Usage

Once connected, click the **Linear logo** in the chat panel to attach tickets to your plan.

When you attach a Linear ticket, the agent can:

* **Read ticket details** — The agent uses the ticket title, description, and comments as context when researching and structuring your plan
* **Update ticket status** — As tasks are completed, the agent can update the corresponding Linear ticket

## Tips

* Attach tickets before asking the agent to research — it will use the ticket context to produce better plans
* You can attach multiple tickets to a single plan if they're related
* The agent can update Linear based on progress, keeping your project management in sync

<Tip>
  Want a Ref plan to open automatically from a Linear ticket? See [Custom Launchers](/plans/integrations/custom-launchers) for the `/new?prompt&content` URL pattern.
</Tip>

## Get help

If you have any issues, please reach out to `help@ref.tools`. We're happy to help you get started!