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

# Linear

> Connect Linear to your Macaly account

Linear is an issue tracker and project management tool for software teams. Connect your account once and the agent can manage your issues and projects directly, or turn activity in your app into tracked work.

<Callout icon="user">
  Available on all plans
</Callout>

## Why connect Linear

* **Turn feedback into tracked issues automatically.** When a bug report or feature request comes in through your app, have the agent file it as a Linear issue so it doesn't get lost in chat.
* **Show your roadmap without opening Linear.** Build a public roadmap or an internal kanban board that pulls your projects and issues, grouped by status.
* **Manage issues from the chat.** File an issue, update its priority, or get a summary of your backlog without leaving Macaly.

## What you need

* A **Linear account**. Create one for free at [linear.app](https://linear.app)

## Connect Linear to Macaly

<Steps>
  <Step title="Open Settings">
    Go to **Settings → Integrations** in your Macaly workspace.
  </Step>

  <Step title="Connect Linear">
    Find the Linear card in the list of apps and click the **Connect** button.
  </Step>

  <Step title="Authorize your account">
    A new window opens, where you'll be asked to sign in to Linear. Once you approve access, you'll be redirected back to Macaly.
  </Step>
</Steps>

## Use Linear from the chat

Once connected, describe what you want and the agent handles the rest.

Turn feedback into issues automatically:

```
When someone submits a bug report on my site, create a Linear
issue in the "Web" team with their description and screenshot.
```

Show your roadmap on your site:

```
Build a public roadmap page that shows our Linear projects and
their milestones, grouped by status.
```

Manage issues directly:

```
Create a Linear issue in the "Web" team titled "Fix mobile nav",
set it to high priority, and assign it to me.
```

```
Find all open issues in Linear labeled "bug" and give me a
summary grouped by assignee.
```

## What the agent can do in Linear

Create, update, assign, and prioritize issues, organize projects, milestones, and cycles, add comments and reactions, link related issues, and fetch issues, projects, and users to bring your work into your project.

## Good to know

* **You connect once.** Every project in your workspace reuses the same Linear connection.
* **Edits apply to your real workspace.** The agent creates and updates actual Linear issues and projects, so be specific about what you want.
* **Your account, your control.** The agent only acts when you ask it to. You can disconnect Linear anytime from **Settings → Integrations**.