linear

Query and mutate Linear issues, projects, cycles, and teams via the GraphQL API.

779|139|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/taracodlabs/aiden --skill linear-taracodlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/taracodlabs/aiden/tree/main/skills/linear
Command: npx skills add https://github.com/taracodlabs/aiden --skill linear-taracodlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Query and mutate Linear data (issues, projects, cycles, and teams) via the Linear GraphQL API to streamline software project management and sprint planning.

Core Features & Use Cases

  • List open issues in a team or project and view their assignees and states.
  • Create new Linear issues and update existing issue statuses or priorities.
  • Retrieve current sprint/cycle progress to monitor delivery across teams.

Quick Start

Set the LINEAR_API_KEY environment variable to your Linear API key and run the provided queries to list, create, or update issues.

Frequently Asked Questions about linear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Linear issue tracking via the GraphQL API?

Automate Linear issue tracking by using the Linear GraphQL API to query and mutate issues, projects, cycles, and teams. You can list open issues, create new issues, update statuses, and inspect sprint progress across multiple teams. It requires a LINEAR_API_KEY in the environment.

What's the best way to create and update Linear issues programmatically?

Create and update Linear issues programmatically by sending GraphQL mutations to the Linear API endpoint. This approach supports setting issue statuses, priorities, and assignees directly through automated scripts.

How can I check current sprint progress across multiple Linear teams?

Check current sprint progress by querying Linear cycles via the GraphQL API. You can retrieve active cycle data to monitor delivery status and open issue counts across multiple teams simultaneously.

Do I need a Linear API key to manage projects through GraphQL?

Yes, you need a Linear API key to manage projects through GraphQL. Set the LINEAR_API_KEY environment variable to authenticate requests sent to the https://api.linear.app/graphql endpoint for querying and mutating project data.

Can I retrieve a list of open issues with assignees and states from Linear?

Yes, you can retrieve a list of open Linear issues with their assignees and states. Query the Linear GraphQL API to list issues filtered by a specific team or project to inspect current workloads and statuses.