Skip to main content
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 with a linear_delegation trigger; they differ in who the agent runs as. No CLI or MCP setup is needed.
1

Connect Linear to Macroscope

An admin connects Linear in Macroscope → Settings → Connections.
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.
2

Create a service profile

An admin creates a service profile 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.
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.
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 or plugins.

​
Troubleshooting