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

# Linear integration

> Delegate Linear issues to Murmur agents.

Delegate a Linear issue to **Macroscope** and a Murmur agent picks it up. It works on the issue, posts progress there, and opens a pull request when the work is ready.

## Setup

There are two paths. Both need a [flight](https://docs.murmur.dev/concepts/flights.md) with a [`linear_delegation` trigger](https://docs.murmur.dev/catalog/flight#linear-delegation-flight); they differ in who the agent runs as. No CLI or MCP setup is needed.

### With GitHub linking (recommended)

**1. Connect Linear to Macroscope**

An admin connects Linear in Macroscope → [Settings → Connections](https://app.macroscope.com/settings#linear).

**2. Create a flight**

An admin creates a flight with a Linear delegation trigger and leaves **Service profile** empty. Unfiltered covers every ticket; filtered covers only those teams, projects or labels.

**3. Connect GitHub in Linear**

Each person who delegates connects GitHub in their Linear account settings, using a GitHub account in the org.

Each agent runs as the person who delegated it, using that person's Murmur account and limited to their repos. Their Murmur account needs working GitHub credentials, and Linear tells them what to fix if not.

### Without GitHub linking

**1. Connect Linear to Macroscope**

An admin connects Linear in Macroscope → [Settings → Connections](https://app.macroscope.com/settings#linear).

**2. Create a service profile**

An admin creates a [service profile](https://docs.murmur.dev/concepts/service-profiles.md) and turns on **Grant borrowers access to all repositories**. Teammates who have linked GitHub also need an access grant on the profile, or their delegations are refused.

**3. Create a flight**

An admin creates a flight with a Linear delegation trigger and sets its service profile to the one from step 2. Filter it or leave it unfiltered; if other Linear flights exist, give it a lower [priority](https://docs.murmur.dev/catalog/flight.md#priority).

Agents run as the service profile itself, with access to every repo the GitHub App is installed on. Anyone in your Linear workspace can delegate, including people outside your GitHub org.

## Use it

Delegate an issue to **Macroscope**. The agent posts progress on the issue and opens a pull request when the work is ready. Comment on the issue to guide the agent, or stop the session to interrupt it.

> [!NOTE]
>
> The Linear integration spawns agents. It doesn't give agents access to search your Linear issues or use Linear as a tool. For tools like that, use workspace [secrets](https://docs.murmur.dev/concepts/secrets.md) or [plugins](https://docs.murmur.dev/integrations/mcp.md#give-agents-other-mcp-servers).

## Troubleshooting

| Symptom | Fix |
| - | - |
| Macroscope missing from the delegate menu | Older connections need reauthorizing. Reconnect Linear in [Settings → Connections](https://app.macroscope.com/settings#linear). |
| No response at all | Connect Linear in [Settings → Connections](https://app.macroscope.com/settings#linear). |
| *"This feature is currently disabled…"* | Contact Macroscope to enable Linear delegation. |
| *"…could not resolve a GitHub account…"* | The delegator connects GitHub in their Linear account settings, or use the [path without GitHub linking](#without-github-linking). |
| *"…is not permitted to…"* | Ask an admin to grant the access the message names. |


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