Linear is a modern project management tool designed for software teams that value speed, keyboard shortcuts, and clean UI. Its API-first architecture makes it ideal for automation and integration with developer workflows. Linear supports cycles (sprints), roadmaps, project tracking, and triage workflows. Deep GitHub and GitLab integrations automatically link issues to pull requests and update status based on branch and merge activity.
Organize work into cycles with automatic carry-over of incomplete issues, velocity tracking, and burndown charts to keep engineering sprints on track.
Automatically transition issue status when branches are created, PRs are opened, and code is merged. Link commits to issues with Linear branch naming conventions.
Plan and visualize multi-team initiatives on a timeline view, breaking epics into trackable milestones that roll up progress across engineering, design, and product teams.
Route incoming bugs through a triage queue with SLA timers, priority classification, and automatic assignment based on component labels and team ownership rules.
import { LinearClient } from "@linear/sdk";const linear = new LinearClient({ apiKey: process.env.LINEAR_API_KEY! });// Create an issue linked to a project cycleexport async function createBugReport(title: string, description: string, teamId: string) {const issue = await linear.createIssue({teamId,title,description,priority: 2, // HighlabelIds: ["bug-label-id"],});return {id: issue.issue?.id,identifier: issue.issue?.identifier,url: issue.issue?.url,};}// Fetch current cycle issues for a teamexport async function getCurrentCycleIssues(teamId: string) {const team = await linear.team(teamId);const activeCycle = await team.activeCycle;if (!activeCycle) return [];const issues = await activeCycle.issues();return issues.nodes.map((issue) => ({id: issue.id,title: issue.title,state: issue.state,assignee: issue.assignee,priority: issue.priority,}));}
Seamless integration, great documentation. Set up in under 10 minutes.
2 days ago
Works well for our use case. Would love to see more webhook event types.
1 week ago
Excellent compliance coverage. HIPAA audit trail works perfectly.
2 weeks ago
| Key | Description | Example |
|---|---|---|
| LINEAR_API_KEY | Personal API key or OAuth token for the Linear API | lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| LINEAR_WEBHOOK_SECRET | Secret for verifying Linear webhook payloads | whsec_xxxxxxxxxxxxxxxxxxxxxxxx |
Linear is a modern, API-first project management tool designed for high-velocity engineering teams. Its deep GitHub integration automatically links branches and PRs to issues, and workflow automation reduces manual status updates. The GraphQL API and SDK make it the best choice for teams that want to build custom integrations and automate their development workflow end-to-end.