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

# Linear

> Connect a Linear workspace to browse and search issues, attach them to lanes and chats, and carry the link through branch names, commits, and PRs.

Connect Linear when your planning and review loop already runs through Linear issues. Once connected, you can browse and search issues from inside ADE, attach an issue to a lane or a chat, and let ADE carry that link through the branch name, commit messages, and the PR — so Linear links the work back to the issue. An optional live-status round-trip reflects an agent's progress back into Linear.

## What the integration does

> [card] Browse & search issues
>
> Open the issue browser from the top bar to search, filter, read comments, and see cycle and sub-issue detail.

> [card] Attach issues
>
> Connect a Linear issue to a lane or chat. ADE derives the lane and branch name and attaches the issue as context.

> [card] Commit & PR linkbacks
>
> Connected lanes prefix commits with the issue reference and seed the PR title and body so Linear links the work back — and closes the issue on merge if you choose.

> [card] Live status (optional)
>
> When enabled, ADE moves the issue to In Progress on launch, comments the PR link, and marks it Done on merge.

## Connect Linear

Connect from **Settings → Integrations**, or from the CTO's Settings sheet. There are two paths:

**1. Sign in with Linear (OAuth)**

The primary path. ADE opens a Linear sign-in and stores the resulting token, refreshing it for you. The sign-in session is short-lived, so finish it promptly.

**2. Personal API key**

The alternative — paste a key that doesn't expire. Good for headless or automated setups.

**3. Test with one issue**

Attach an issue to a lane and confirm it shows up in the lane and in chat context.

![The Linear quick view in ADE](https://mintcdn.com/ade-ac1c6011/Mghbi7-G0yTaUGxT/media/current/linear.jpg?fit=max\&auto=format\&n=Mghbi7-G0yTaUGxT\&q=85\&s=29fd2719ba71c107df709e8870c7bf0c)

The Linear quick view: issues, projects, and a one-click agent launch.

> [!TIP]
>
> You can also connect from a chat. When an agent needs Linear, it shows a connect card in the chat with the same two paths. ADE checks the key with Linear and saves it for the project. The agent never sees it.

> [!NOTE]
>
> Until a token is stored, the integration stays dormant — nothing polls and nothing binds. Connecting is a deliberate act.

## From issue to PR

The everyday flow starts with an issue and ends with a linked PR.

**1. Attach an issue**

Create a lane from an issue (or attach one to an existing lane or chat). ADE derives the lane name and branch name from the issue and attaches it as context.

**2. Work in the lane**

The agent implements in its worktree. Commit messages are auto-prefixed with the issue reference.

**3. Open a PR**

The PR title and body are seeded from the issue, with a `Fixes` or `Refs` magic word so Linear links — and optionally closes — the issue on merge.

**4. Live status (optional)**

With the live-status round-trip enabled, ADE moves the issue to In Progress on launch, comments the PR link, and marks it Done on merge.

### Launch several issues at once

From the issue browser you can multi-select issues and launch them together — one lane per issue, optionally with an agent kickoff prompt each. Failures are isolated so one bad issue doesn't stop the rest, and you can retry just the ones that failed.

> [!NOTE]
>
> Linear triggers in [Automations](https://ade-app.dev/docs/tools/automations.md) are context-only. There is no autonomous issue-routing engine — any Linear write from an automation is an explicit rule action.

## Good CTO prompts with Linear

```text theme={null}
Read ENG-142 and propose a lane plan with acceptance criteria.
```

```text theme={null}
Summarize what changed on the PR linked to ENG-142 and draft a Linear update.
```

```text theme={null}
Which of my Linear issues are ready to start?
```

> [card] [Set up the CTO](https://ade-app.dev/docs/cto/setup.md)
>
> Pick a personality and work style, then optionally choose a model and connect Linear.

> [card] [CTO overview](https://ade-app.dev/docs/cto/overview.md)
>
> The persistent operator that can browse and update Linear issues from its thread.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.