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
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
Does Windmill modify anything in Linear?No. The integration is strictly read-only. Does Windmill store full issue text?
By default, Windmill stores summaries and metadata. Full descriptions are optional and controlled via permissions. How often is data synced?
Continuously. Updates appear in Windmill shortly after they happen in Linear. Is this integration secure?
Yes. All data is encrypted in transit and at rest. Windmill is SOC 2 compliant and uses scoped OAuth tokens. 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.