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

# Linear

> Connect Linear to Windmill to bring issues, projects, and engineering progress into recaps, 1:1 prep, and performance reviews with per-person attribution.

## Benefits of connecting Linear to Windmill

Connecting Linear to Windmill brings engineering and product work directly into 1:1s and performance reviews — so contributions are recognized continuously, not reconstructed from memory.

* Captures real work as it happens (issues, PR links, progress updates)
* Reduces review prep time for engineers and managers
* Highlights collaboration, ownership, and problem-solving patterns
* Ensures quieter but meaningful contributions don’t get overlooked
* Makes performance evaluations more fair, accurate, and grounded in actual output

Windmill turns ongoing Linear activity into structured insight for coaching, recognition, and growth.

## Connected data

When connected, Windmill securely reads **metadata** about work in Linear:

| Data Type                               | How Windmill Uses It                                    |
| --------------------------------------- | ------------------------------------------------------- |
| Issues created, assigned, and completed | Shows ownership, contribution, and delivery consistency |
| Status changes & cycle progress         | Highlights workflow patterns and execution reliability  |
| Linked PRs / commits metadata           | Provides context without ingesting code                 |
| Comments, discussions, and handoffs     | Surfaces teamwork, communication, and problem-solving   |
| Projects, roadmaps, and labels          | Helps contextualize type and scope of work              |

> Windmill ingests **activity signals**, not full private code or sensitive content.

## Permissions

Windmill requests **read-only**, scoped access through Linear’s API.

| Permission                                   | Purpose                                                   |
| -------------------------------------------- | --------------------------------------------------------- |
| Read issues and project metadata             | To reflect progress and ownership in reviews and coaching |
| Read comment metadata and change history     | To understand collaboration and decision-making patterns  |
| Read user + team assignment information      | To map work to the correct employee profile in Windmill   |
| **No write access**                          | Windmill never modifies issues, comments, or workflows    |
| **Scoped access to specific teams/projects** | You choose what is and is not included in sync            |

> Windmill follows **least-privilege access** — only syncing data needed for performance context.

## FAQs

<AccordionGroup>
  <Accordion title="Does Windmill modify anything in Linear?">
    No. The integration is strictly read-only.
  </Accordion>

  <Accordion title="Does Windmill store full issue text?">
    By default, Windmill stores summaries and metadata. Full descriptions are optional and controlled via permissions.
  </Accordion>

  <Accordion title="How often is data synced?">
    Continuously. Updates appear in Windmill shortly after they happen in Linear.
  </Accordion>

  <Accordion title="Is this integration secure?">
    Yes. All data is encrypted in transit and at rest. Windmill is SOC 2 compliant and uses scoped OAuth tokens.
  </Accordion>

  <Accordion title="What happens when an engineer changes teams or leaves?">
    Historical contributions remain visible for context, but Windmill stops associating new work once the user is deactivated.
  </Accordion>
</AccordionGroup>

***