linear.app

# Linear

> Linear is a purpose-built tool for planning and building products. Meet the system for modern software development. Streamline issues, projects, and product roadmaps.

> For agents: connect to the Linear MCP server at https://mcp.linear.app/mcp to read and change issues, projects, and documents. Setup guide: https://linear.app/docs/mcp.md. Index of all docs: https://linear.app/llms.txt.

Each page on linear.app is also available as Markdown. Add `.md` to the URL (use `/index.md` for the homepage), or send the `Accept: text/markdown` header.

## Website

- [/](https://linear.app/index.md)
- [/about](https://linear.app/about.md)
- [/agents](https://linear.app/agents.md)
- [/ai](https://linear.app/ai.md)
- [/careers](https://linear.app/careers.md)
- [/changelog](https://linear.app/changelog.md)
- [/coding-sessions](https://linear.app/coding-sessions.md)
- [/resource-kit](https://linear.app/resource-kit.md)
- [/contact](https://linear.app/contact.md)
- [/contact/sales](https://linear.app/contact/sales.md)
- [/contact/support](https://linear.app/contact/support.md)
- [/customers](https://linear.app/customers.md)
- [/customer-requests](https://linear.app/customer-requests.md)
- [/data](https://linear.app/data.md)
- [/enterprise](https://linear.app/enterprise.md)
- [/features](https://linear.app/features.md)
- [/asks](https://linear.app/asks.md)
- [/insights](https://linear.app/insights.md)
- [/intake](https://linear.app/intake.md)
- [/integrations](https://linear.app/integrations.md)
- [/method](https://linear.app/method.md)
- [/releases/2020-12](https://linear.app/releases/2020-12.md)
- [/releases/2021-06](https://linear.app/releases/2021-06.md)
- [/releases/2022](https://linear.app/releases/2022.md)
- [/releases/figma](https://linear.app/releases/figma.md)
- [/security](https://linear.app/security.md)
- [/security/vulnerability](https://linear.app/security/vulnerability.md)
- [/startups](https://linear.app/startups.md)
- [/dpa](https://linear.app/dpa.md)
- [/legal](https://linear.app/legal.md)
- [/privacy](https://linear.app/privacy.md)
- [/terms](https://linear.app/terms.md)
- [/brand](https://linear.app/brand.md)
- [/change](https://linear.app/change.md)
- [/download](https://linear.app/download.md)
- [/now](https://linear.app/now.md)
- [/fm](https://linear.app/fm.md)
- [/pricing](https://linear.app/pricing.md)
- [/readme](https://linear.app/readme.md)
- [/plan](https://linear.app/plan.md)
- [/build](https://linear.app/build.md)
- [/mobile](https://linear.app/mobile.md)
- [/quality](https://linear.app/quality.md)
- [/switch](https://linear.app/switch.md)
- [/switch/migration-guide](https://linear.app/switch/migration-guide.md)
- [/switch/pilot-guide](https://linear.app/switch/pilot-guide.md)
- [/switch/pitch-guide](https://linear.app/switch/pitch-guide.md)

## Documentation

Get an overview of Linear's features, integrations, and how to use them.

### Getting started

- [Start Guide](https://linear.app/docs/start-guide.md)
  - [Concepts](https://linear.app/docs/conceptual-model.md)
  - [Download Linear](https://linear.app/docs/get-the-app.md)

### Intake

- [Triage](https://linear.app/docs/triage.md)
- [Linear Asks](https://linear.app/docs/linear-asks.md)
  - [Asks with Slack](https://linear.app/docs/linear-asks-slack.md)
  - [Asks with Email](https://linear.app/docs/linear-asks-email.md)
  - [Asks Web Forms](https://linear.app/docs/linear-asks-web-forms.md)
- [Customer Requests](https://linear.app/docs/customer-requests.md)

### Planning

- [Projects](https://linear.app/docs/projects.md)
  - [Project milestones](https://linear.app/docs/project-milestones.md)
  - [Project priority](https://linear.app/docs/project-priority.md)
  - [Project status](https://linear.app/docs/project-status.md)
  - [Project labels](https://linear.app/docs/project-labels.md)
  - [Project dependencies](https://linear.app/docs/project-dependencies.md)
  - [Project notifications](https://linear.app/docs/project-notifications.md)
  - [Project templates](https://linear.app/docs/project-templates.md)
- [Initiatives](https://linear.app/docs/initiatives.md)
  - [Sub-initiatives](https://linear.app/docs/sub-initiatives.md)
- [Initiative and project updates](https://linear.app/docs/initiative-and-project-updates.md)

### Issues and cycles

- [Issues](https://linear.app/docs/creating-issues.md)
  - [Issue properties](https://linear.app/docs/issue-properties-home.md)
  - [Parent and sub-issues](https://linear.app/docs/parent-and-sub-issues.md)
  - [Assign and delegate issues](https://linear.app/docs/assigning-issues.md)
  - [Issue templates](https://linear.app/docs/issue-templates.md)
  - [Comments and reactions](https://linear.app/docs/comment-on-issues.md)
  - [Select issues](https://linear.app/docs/select-issues.md)
  - [Delete and archive issues](https://linear.app/docs/delete-archive-issues.md)
- [Cycles](https://linear.app/docs/use-cycles.md)
- [Releases](https://linear.app/docs/releases.md)

### Reviews

- [Reviews](https://linear.app/docs/diffs.md)
- [Coding settings](https://linear.app/docs/code-and-reviews.md)

### Agents and automation

- [Linear Agent](https://linear.app/docs/linear-agent.md)
  - [Code Intelligence](https://linear.app/docs/code-intelligence.md)
- [Linear cloud coding agent](https://linear.app/docs/linear-cloud-coding-agent.md)
- [Loops](https://linear.app/docs/loops.md)
- [Agent platform](https://linear.app/docs/agents-in-linear.md)
- [Triage Intelligence](https://linear.app/docs/triage-intelligence.md)
- [MCP server](https://linear.app/docs/mcp.md)

### Insights and outcomes

- [Dashboards](https://linear.app/docs/dashboards.md)
- [Insights](https://linear.app/docs/insights.md)
- [Project graph](https://linear.app/docs/project-graph.md)
- [Cycle graph](https://linear.app/docs/cycle-graph.md)

### Working in Linear

- [Inbox](https://linear.app/docs/inbox.md)
- [Documents](https://linear.app/docs/documents.md)
- [Pulse](https://linear.app/docs/pulse.md)
- [Custom Views](https://linear.app/docs/custom-views.md)
  - [Board layout](https://linear.app/docs/board-layout.md)
  - [Timeline](https://linear.app/docs/timeline.md)
  - [Filters](https://linear.app/docs/filters.md)
  - [Display options](https://linear.app/docs/display-options.md)
- [Editor](https://linear.app/docs/editor.md)
- [Search](https://linear.app/docs/search.md)
- [My issues](https://linear.app/docs/my-issues.md)
- [Favorites](https://linear.app/docs/favorites.md)
- [Notifications](https://linear.app/docs/notifications.md)
- [Preferences](https://linear.app/docs/account-preferences.md)
- [Profile](https://linear.app/docs/profile.md)
- [Security & Access](https://linear.app/docs/security-and-access.md)

### Integrations

- [GitHub](https://linear.app/docs/github-integration.md)
- [Jira](https://linear.app/docs/jira.md)
- [Microsoft Teams](https://linear.app/docs/microsoft-teams.md)
- [Sentry](https://linear.app/docs/sentry.md)
- [Slack](https://linear.app/docs/slack.md)
- [Integration Directory](https://linear.app/docs/integration-directory.md)
  - [Zendesk](https://linear.app/docs/zendesk.md)
  - [Intercom](https://linear.app/docs/intercom.md)
  - [Salesforce](https://linear.app/docs/salesforce.md)
  - [Google Sheets](https://linear.app/docs/google-sheets.md)
  - [GitLab](https://linear.app/docs/gitlab.md)
  - [Figma](https://linear.app/docs/figma.md)
  - [Gong](https://linear.app/docs/gong.md)
  - [Airbyte](https://linear.app/docs/airbyte.md)
  - [Zapier](https://linear.app/docs/zapier.md)
  - [Notion](https://linear.app/docs/notion.md)
  - [Origin](https://linear.app/docs/origin.md)
  - [Discord](https://linear.app/docs/discord.md)
  - [Front](https://linear.app/docs/front.md)

### Workspace management

- [Workspaces](https://linear.app/docs/workspaces.md)
- [Teams](https://linear.app/docs/teams.md)
  - [Private teams](https://linear.app/docs/private-teams.md)
  - [Sub-teams](https://linear.app/docs/sub-teams.md)
  - [Team pages](https://linear.app/docs/default-team-pages.md)
- [Login methods](https://linear.app/docs/login-methods.md)
- [Invite members](https://linear.app/docs/invite-members.md)
- [Members and roles](https://linear.app/docs/members-roles.md)
- [SAML](https://linear.app/docs/saml-and-access-control.md)
- [SCIM](https://linear.app/docs/scim.md)
- [API and Webhooks](https://linear.app/docs/api-and-webhooks.md)
- [Third-Party App Approvals](https://linear.app/docs/third-party-application-approvals.md)
- [Security](https://linear.app/docs/security.md)
- [Audit log](https://linear.app/docs/audit-log.md)
- [Billing and plans](https://linear.app/docs/billing-and-plans.md)
- [AI Credits](https://linear.app/docs/ai-credits.md)
  - [Usage & limits](https://linear.app/docs/usage-and-limits.md)
- [Exporting Data](https://linear.app/docs/exporting-data.md)

### Importers

- [Import Guide](https://linear.app/docs/import-issues.md)
  - [Jira](https://linear.app/docs/jira-to-linear.md)
  - [GitHub Issues](https://linear.app/docs/github-to-linear.md)
  - [Asana](https://linear.app/docs/asana-to-linear.md)
  - [Shortcut](https://linear.app/docs/shortcut-to-linear.md)
  - [Linear](https://linear.app/docs/linear-to-linear.md)
  - [CLI Importer](https://linear.app/docs/cli-importer.md)

## Developers

Learn about building apps and integrations for Linear using the GraphQL API and TypeScript SDK.

### GraphQL Schema

- [GraphQL SDL Schema Definition](https://raw.githubusercontent.com/linear/linear/master/packages/sdk/src/schema.graphql)

### GraphQL API

- [Getting started](https://linear.app/developers/graphql.md)
- [Pagination](https://linear.app/developers/pagination.md)
- [Filtering](https://linear.app/developers/filtering.md)
- [Rate limiting](https://linear.app/developers/rate-limiting.md)
- [Deprecations](https://linear.app/developers/deprecations.md)
- [Webhooks](https://linear.app/developers/webhooks.md)
- [Attachments](https://linear.app/developers/attachments.md)
- [Managing Customers](https://linear.app/developers/managing-customers.md)

### Authentication

- [OAuth 2.0 authentication](https://linear.app/developers/oauth-2-0-authentication.md)
- [OAuth actor authorization](https://linear.app/developers/oauth-actor-authorization.md)
- [OAuth application manifests](https://linear.app/developers/oauth-app-manifests.md)
- [File storage authentication](https://linear.app/developers/file-storage-authentication.md)

### Agents

- [Agent Interaction Guidelines (AIG)](https://linear.app/developers/aig.md)
- [Getting Started](https://linear.app/developers/agents.md)
- [Developing the Agent Interaction](https://linear.app/developers/agent-interaction.md)
- [Interaction Best Practices](https://linear.app/developers/agent-best-practices.md)
- [Signals](https://linear.app/developers/agent-signals.md)

### TypeScript SDK

- [Getting started](https://linear.app/developers/sdk.md)
- [Fetching & modifying data](https://linear.app/developers/sdk-fetching-and-modifying-data.md)
- [Errors](https://linear.app/developers/sdk-errors.md)
- [Advanced usage](https://linear.app/developers/advanced-usage.md)
- [Webhooks](https://linear.app/developers/sdk-webhooks.md)
- [Migrating from 1.x to 2.x](https://linear.app/developers/migrating-from-1-x-to-2-x.md)
- [GitHub](https://github.com/linear/linear/tree/master/packages/sdk)

### Guides

- [How to upload a file to Linear](https://linear.app/developers/how-to-upload-a-file-to-linear.md)
- [Create issues using linear.new](https://linear.app/developers/create-issues-using-linear-new.md)
- [Integration Directory](https://linear.app/developers/integration-directory.md)