linear

Manage Linear issues and projects via GraphQL queries and mutations with curl.

Updated May 5, 2026
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill linear-z43l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/Z43L/zeus-agent --skill linear-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Linear issues, projects, and team workflows are difficult to manage at scale through the UI, especially when you want repeatable, scriptable updates.

Core Features & Use Cases

  • Issue & Project Management via GraphQL: Create issues, update state/priority/assignees, manage labels, and add comments directly using Linear’s GraphQL API with curl.
  • Workflow-State Driven Status Updates: Move issues through team-specific workflow state types by resolving the correct stateId first (e.g., backlog, started, completed).
  • Search, Filtering & Pagination: Query teams, workflow states, list/search issues, and handle Relay-style cursor pagination for predictable data retrieval.

Quick Start

Create a Linear personal API key, set LINEAR_API_KEY in your environment, and run a GraphQL query or mutation with curl to list your teams or fetch an issue by identifier like ENG-123.

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 management using the GraphQL API?▼

Automate Linear issue management by sending GraphQL queries and mutations via curl to the Linear API endpoint. You can script operations like creating issues, updating priority, and adding comments using a POST JSON payload.

How do I move a Linear issue to a new workflow state with curl?▼

To move a Linear issue to a new workflow state, query your team's workflow states to find the correct stateId, then send a GraphQL mutation via curl to update the issue with that specific stateId.

How do I handle Relay-style pagination when searching Linear issues?▼

Handle Relay-style pagination in Linear by using the `first` and `after` cursor parameters in your GraphQL queries. This retrieves predictable batches of issue data from the Linear API endpoint over curl.

What do I need to authenticate curl requests to the Linear GraphQL API?▼

Authenticating Linear GraphQL API requests requires setting the `LINEAR_API_KEY` environment variable and passing it as an authorization header in your curl command.

Can I batch create and update Linear projects and labels without the UI?▼

Yes, you can batch manage Linear projects and labels without the UI by scripting GraphQL mutations with curl. This allows repeatable, automated updates to team workflows and issue tracking at scale.