linear

Query and mutate Linear issues, projects, and teams via GraphQL with curl.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/attentiondotnet/hermes-agent --skill linear-attentiondotnet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/attentiondotnet/hermes-agent/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/attentiondotnet/hermes-agent --skill linear-attentiondotnet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simplify and accelerate the management of Linear data by enabling programmatic access to issues, projects, and teams through a GraphQL API using curl, removing the need for manual UI interactions in automation pipelines.

Core Features & Use Cases

  • GraphQL-powered control: query, create, update, and search Linear entities (issues, projects, teams) via the REST-free GraphQL API.
  • No OAuth needed: authenticate with a simple API key, enabling quick scripted workflows.
  • Automation-friendly workflows: integrate with CI/CD, bots, and batch processes to maintain backlogs and track progress.

Quick Start

Set LINEAR_API_KEY in your environment and run a sample GraphQL curl query against the Linear API.

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 without OAuth?

Automate Linear issue management without OAuth by using an API key with GraphQL via curl. You simply set the LINEAR_API_KEY environment variable and POST JSON requests to the Linear GraphQL endpoint to mutate issues.

Can I create and update Linear projects using curl?

Yes, you can create and update Linear projects using curl by sending POST requests with application/json content type to the Linear GraphQL API. This enables scripted project planning and automated backlog maintenance.

What is needed to query Linear data via GraphQL in CI/CD pipelines?

To query Linear data via GraphQL in CI/CD pipelines, you need the LINEAR_API_KEY environment variable and curl to send POST requests to the API endpoint. This enables automated status updates and issue triage directly from scripts.

Does this approach to Linear automation work for batch processing issues?

Yes, this GraphQL approach works for batch processing Linear issues. It is designed for teams of any size performing frequent issue triage, allowing automated management of issues, projects, and teams directly from automation pipelines.

Why use GraphQL instead of REST for Linear automation scripts?

Use GraphQL instead of REST for Linear automation scripts to query, create, update, and search Linear entities through a single endpoint. This REST-free approach removes manual UI interactions and simplifies batch process workflows.