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

# Linear

> Connect Linear to PlayerZero for AI-assisted issue tracking and triage.

Linear is a project management and issue tracking tool designed for software teams.

## What You Can Do

Once connected, PlayerZero AI agents can:

* **Search issues** — Find issues using multi-filter search across team, state, assignee, labels, and text queries
* **Read issues and comments** — Access full issue details, descriptions, project associations, subscribers, and comment history for context during debugging
* **Create issues** — Create new issues with team, title, description, state, priority, labels, assignees, estimates, and project assignment
* **Update issues** — Modify existing issues including state, priority, labels, assignees, description, and subscriber lists
* **Add comments** — Post investigation results, root cause analysis, or reproduction steps directly to issues
* **Update comments** — Edit existing comment content
* **Reply to comments** — Create threaded replies on existing comments
* **Delete comments** — Remove comments created by the integration
* **Search and browse labels** — Discover available labels with parent/child hierarchy support and team-scoped filtering
* **Manage labels** — Create new labels for organizing issues
* **Create projects** — Set up new Linear projects with team association
* **Create sub-issues** — Create nested issues under a parent issue for breaking down work
* **Create and assign milestones** — Create project milestones and assign issues to them by name
* **Delete and archive issues** — Remove or archive issues that are no longer needed
* **Search teams and projects** — Discover teams, list projects, and search across your Linear workspace for context
* **Access workspace context** — Understand team structure, workflow states, and member details to provide relevant assistance

## Use Cases

* **Automated triage** - AI agents analyze incoming issues and suggest priority, labels, or assignees based on code analysis
* **Debug-to-ticket workflow** - Convert debug findings into well-documented Linear issues with one click
* **Context-aware support** - When investigating issues, agents pull in related Linear tickets for full context

## Scopes & Permissions

<Info>
  PlayerZero requests only the permissions needed for AI agents to assist with debugging and issue management. We follow the principle of least privilege—each permission directly enables a specific capability.
</Info>

| Scope             | Why It's Needed                                                                                                                                                |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `read`            | **Context gathering** — Allows AI agents to read issue details, comments, and project structure when investigating bugs or answering questions about your work |
| `write`           | **Issue management** — Enables agents to update issue status, add labels, or modify descriptions when you ask them to triage or update tickets                 |
| `issues:create`   | **Ticket creation** — Lets agents create new Linear issues directly from debug sessions, converting findings into actionable work items                        |
| `comments:create` | **Investigation notes** — Allows agents to post root cause analysis, reproduction steps, or code references as comments on existing issues                     |
| `admin`           | **Workspace awareness** — Provides access to team structure and workflow configuration so agents can suggest appropriate assignees and labels                  |

## Setup

<Note>
  Setup starts in PlayerZero—no pre-configuration in Linear is required.
</Note>

1. In PlayerZero, navigate to **Settings → Context → Ticketing**
2. Find **Linear** and click **Connect**
3. You'll be redirected to Linear to log in and authorize PlayerZero
4. After authorization, select which PlayerZero projects should have access to this integration

## Get Started

👉 [AI Player overview](/features/ai-player)

👉 [Setup guide](/developer-guide/quickstart-guide)