> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aosplane.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aosplane.io/_mcp/server.

# Linear

Connect your Linear workspace to browse issues in AOSplane and start a session from any of them. Install the AOSplane agent in Linear too, and your team can hand an issue to AOSplane without leaving Linear.

> **Note**
>
> Owners, Admins and Engineers can connect Linear and manage the rules that pick a project for each issue. Only Owners and Admins install the AOSplane agent in Linear.

## Connect Linear

#### Open Linear

Choose **PM** in the narrow rail on the far left, then **Linear** under **Issues**. Or open **Settings** › **Connections** and choose **Connect** next to **Linear**.

#### Authorize

Choose **Connect Linear** and approve AOSplane in Linear.

#### Check the result

The top of the page shows your workspace as **Connected**.

## Start a session from an issue

#### Find the issue

On the **Issues** tab, search by title or key (like `ENG-482`), or filter by team, state and assignee.

#### Start

Choose **Start session** on its row, or open the issue and choose **Start coding session**.

#### Choose where it runs

Pick the **Target project** and **Agent**. The request is filled in as "Implement" plus the issue's key, title, description and link.

#### Send it

Start the session. It's linked to the issue, and the row shows **Open session**.

![Linear page with the workspace pill, Create issue button and the Routing, Issues and Connection tabs, showing the Issues list](/_fern-files/_img/28b0cbe7b1f93e86f2ed0a202916b7529cb68524ce0f4329953a462c7be7109c.webp)

## Hand issues to AOSplane from Linear

#### Install the agent

On the **Connection** tab, under **AOSplane agent**, choose **Install agent** and approve it in Linear.

#### Add rules

On the **Routing** tab, choose **Add rule**. Pick a **Linear team**, which issues it covers (**Any issue**, **Have a label** or **In a Linear project**), the project to **Start sessions in** and an **Agent**. Choose **Save rule**.

#### Set a default

Turn on **Use as the default** on one rule so issues from teams with no rule still start somewhere.

#### Hand off in Linear

In Linear, delegate an issue to AOSplane or mention it. A session starts in the project your rules pick, and AOSplane answers in the issue when each turn finishes.

![Routing tab with a table of rules showing the Linear team, the project sessions start in and the agent, plus the Any other team row](/_fern-files/_img/e659967da79179e4b602090d9afe45559ea2db9ddd16975811391d46c565f25d.webp)

## Good to know

* Replies in the Linear issue continue the same session.
* Sessions started from Linear run as the person who installed the agent, so they need a connected GitHub account and an AI account.
* A handed-off issue is added to the project's [tasks](/tasks).
* **Check where an issue would go**, on the **Routing** tab, shows which rule an issue matches.
* **Create issue** at the top of the page files a new Linear issue. Turn on **Hand to AOSplane** to start work on it at once.
* Disconnecting Linear stops AOSplane reading and updating issues. Sessions already linked to issues keep their links.
* The [product manager](/product-manager) reads Linear for evidence and can file its brief as a Linear issue.

## Related

* [Tasks](/tasks)
* [Product manager](/product-manager)
* [Start a session](/start-a-session)