> ## Documentation Index > Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Linear Linear is a project management tool built for development teams to track issues, plan sprints, and coordinate work. Connecting Linear to Duvo lets your agents create, update, and manage issues directly in your Linear workspace as part of automated workflows. ## Setup Click **Enable** on the [Connections page](https://app.duvo.ai/integrations) and authorize with your Linear account. ### Admin approval on Enterprise workspaces If your Linear workspace is on the Enterprise plan and has [third-party application approvals](https://linear.app/docs/third-party-application-approvals) enabled, a workspace admin needs to approve **Duvo** once before members can connect. When a non-admin clicks **Enable**, Linear prompts them to request approval instead of completing authorization — an admin then approves Duvo workspace-wide from Linear's settings. On Free, Standard, and Plus workspaces, or on Enterprise workspaces without approvals enabled, any member can connect their own account directly. ## Capabilities * **Create and update issues** — Open new issues with titles, descriptions, and priorities, or update existing ones as workflows progress. * **Manage comments and attachments** — Add context to issues by posting comments, attaching files, or downloading existing attachments. * **Organize with labels** — Create, apply, and remove labels to keep issues categorized and easy to find. * **Retrieve project and team data** — Pull issue details, list projects, view team members, and access cycle or sprint information. * **Run advanced queries** — Execute custom queries for reporting or specialized data retrieval. * **Linear triggers** — Start a Run automatically when a Linear issue is created, assigned, changes workflow state, or gets a new comment. See [Triggers](#triggers) for event types and filter options. ## Triggers Linear triggers fire in real time as activity happens in the Linear workspace you connected. Pick one event type per trigger, then narrow it down with optional filters. ### Event types | Event | Starts a Run when… | | ----------------------- | ------------------------------------------------------------------------------------------ | | **New issue** | A new issue is created. | | **Issue assigned** | An issue is assigned to someone. | | **Issue state changed** | An issue moves into a new workflow state (for example, from **Started** to **Completed**). | | **New comment** | A comment is posted on any issue. | ### Filters All filters are optional. Leave a filter empty to match everything. | Filter | Applies to | What it does | | --------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Teams** | All events | Only fire for issues in specific Linear teams. Add one or more team keys (for example, `ENG`, `DESIGN`). Leave empty to match every team in the workspace. | | **Assignee** | All events | Only fire when the issue is assigned to a specific person. Add one or more Linear user IDs, or use `me` to match whoever connected Linear to Duvo. | | **Workflow state** | New issue | Only fire when the new issue lands in one of the selected state categories: **Triage**, **Backlog**, **Unstarted**, **Started**, **Completed**, or **Canceled**. | | **Destination state** | Issue state changed | Only fire when the issue moves into one of the selected state categories: **Triage**, **Backlog**, **Unstarted**, **Started**, **Completed**, or **Canceled**. | Each matching Linear event starts its own Run, and the Run prompt includes the issue context (title, description, team, assignee, state) so the Agent can act on it without extra lookups. The trigger watches the entire Linear workspace you connected — activity from any team or user in that workspace can match, subject to the filters above. ## Key Benefits * **Automated issue creation** — Generate tickets automatically from workflow events, customer requests, or bug reports without manual entry. * **Event-driven automation** — Kick off Duvo workflows the moment a Linear event occurs — no polling, no manual triggers, no delays. * **Synchronized tracking** — Keep Linear updated in real time as your workflows execute and tasks complete. * **Consistent documentation** — Ensure every issue is created with complete, standardized information. * **Less context switching** — Let agents handle routine issue management while you focus on higher-value work. ## Works Well With Automatically create Linear issues from incoming support emails or customer requests, keeping your inbox and backlog in sync. Automatically create Linear issues from incoming support emails or customer requests, keeping your inbox and backlog in sync. Post issue updates to team channels when agents create or close Linear issues, keeping everyone informed without manual status reports. Generate project summaries or sprint reports in your documentation tool based on Linear issue data. Generate project summaries or sprint reports in your documentation tool based on Linear issue data.