---
title: "Linear"
description: "Route Linear mentions and delegated issues into a project"
canonical_url: "https://hoplite.sh/docs/integrations/linear"
markdown_url: "https://hoplite.sh/docs/integrations/linear.md"
---

# Linear
URL: /docs/integrations/linear
LLM index: /llms.txt
Description: Route Linear mentions and delegated issues into a project
Related: /docs/integrations, /docs/threads, /docs/agent/tools

# Linear

Connect Linear to delegate issues to Hoplite agents directly from your issue tracker.

## Setup

1. **Install** — under **Settings → Integrations**, connect your Linear workspace.
2. **Bind (optional for agent tools)** — in the selected project's area of **Settings → Integrations**, bind a Linear **project or team** to a Hoplite project when mentions and delegated issues from that part of Linear should route into this project. A binding narrows that project's agent to the selected Linear workspace; it is not required for default agents to use the organization's connected Linear tools.

## Working with issues

Once connected, MCP-capable default parent agents receive Linear's built-in MCP tools for every active Linear workspace in their organization. When a project has an enabled Linear binding, its agents use that bound workspace instead.

Linear issues also surface on the **Issues** page in Hoplite. Delegating an issue kicks off agent work against the bound project, with the issue's context carried into the run — and progress flows back to where the team is watching.

From an issue row or its detail page, choose **Spawn thread** to open the new
thread dialog prefilled with the issue title, description, and Linear
identifier. The dialog stays scoped to the project that supplied the issue, so
the resulting thread links and executes against the correct repository.

## Linked issues in threads

The agent attaches Linear issues to [threads](/docs/threads) with its `thread_link_linear_issue` [tool](/docs/agent/tools). It uses the tool proactively when a prompt includes an issue reference, and inbound Linear agent sessions attach the originating issue automatically. The linked issue appears as the compact Linear pill used alongside pull requests in thread views. Linking only stores Hoplite thread metadata; it does not read from or write to Linear.

Agents use Linear's read and write tools only when you explicitly ask them to access Linear. Linking an issue, working on its implementation, or opening a pull request does not by itself authorize the agent to read or change Linear.

## Sitemap

See the full [sitemap](/docs/sitemap.md) for all pages.
Well-known sitemap: [/docs/.well-known/sitemap.md](/docs/.well-known/sitemap.md).