| name | linear-docs |
| description | Use when working with Linear product workflows, issues, projects, cycles, initiatives, views, integrations, workspace administration, AI agents, MCP, GraphQL API, OAuth, webhooks, or the Linear TypeScript SDK |
Linear Documentation
Official Linear product and developer documentation synchronized from Linear's llms.txt.
Start Here
- Open the generated documentation index to select the exact topic.
- Read the matching product page under
references/docs/ or developer page under references/developers/.
- For GraphQL fields and types, search
references/developers/schema.graphql instead of loading the full schema.
Completion means the answer is grounded in the relevant synchronized page and API/schema claims use the exact documented names.
Search
rg -n "<keyword>" references/docs
rg -n "<keyword>" references/developers --glob '*.md'
rg -n "^(type|input|enum|interface|scalar|directive).*<Name>|^[[:space:]]+<field>" references/developers/schema.graphql
The schema is large. Read only a small line window around each rg result.
Topic Routing
| Need | Reference |
|---|
| Product concepts and first setup | Start Guide, Concepts |
| Issues, properties, templates, triage | Create issues, Edit issues, Triage |
| Projects, initiatives, milestones, dependencies | Project overview, Milestones, Dependencies |
| Cycles, views, filters, dashboards | Cycles, Custom views, Filters, Dashboards |
| Teams, members, security, SAML, SCIM | Teams, Roles, Security, SCIM |
| GitHub, GitLab, Slack and other integrations | Integration Directory, GitLab, Slack |
| Linear Agent, coding sessions, MCP | Linear Agent, Coding sessions, MCP server |
| GraphQL pagination, filtering, rate limits | Pagination, Filtering, Rate limiting |
| OAuth and application authorization | OAuth 2.0, Actor authorization, App manifests |
| Webhooks and attachments | Webhooks, Attachments, File storage auth |
| Agent Interaction Guidelines | AIG, Agent interaction, Best practices |
| TypeScript SDK | Fetching and modifying data, Errors, Advanced usage |
| Exact GraphQL contract | references/developers/schema.graphql |
Boundaries
- Product documentation describes behavior and workspace configuration; developer documentation describes integration contracts. Read both when a workflow crosses that boundary.
- Verify GraphQL names against the synchronized SDL. Examples in prose can omit optional fields or use a simplified query.
- Distinguish personal API keys, OAuth access tokens, webhook signatures, and file-storage signatures; they have different authentication and verification rules.
- Use the source page's current plan, role, and permission qualifiers. Do not generalize an Enterprise/admin-only capability to every workspace.
- The upstream GitHub integration page is currently incomplete and is intentionally not mirrored. Use the Integration Directory and official live source until Linear restores its content.
