Linear is a project management and issue tracking tool designed for software teams.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.
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
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.
| 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
Setup starts in PlayerZero—no pre-configuration in Linear is required.
- In PlayerZero, navigate to Settings → Context → Ticketing
- Find Linear and click Connect
- You’ll be redirected to Linear to log in and authorize PlayerZero
- After authorization, select which PlayerZero projects should have access to this integration