linear

Manage Linear issues, projects, and teams via GraphQL API using curl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to streamline Linear workflow by programmatically managing issues, projects, and teams via the GraphQL API using curl, reducing manual overhead and context switching.

Core Features & Use Cases

  • GraphQL-based management: create, query, update, and fetch issues, projects, and teams directly from Linear.
  • No OAuth required: works with a personal API key (LINEAR_API_KEY) without additional auth flows.
  • Common workflows: automate task creation, status updates, and data retrieval to feed dashboards or CI/CD pipelines.
  • Use Case: automatically sync newly opened Linear issues to an external tracker for visibility.

Quick Start

Authenticate with LINEAR_API_KEY and make your first GraphQL query to list issues.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I manage Linear issues using the GraphQL API with curl?

Managing Linear issues via GraphQL with curl involves sending POST requests to the Linear API endpoint using your personal LINEAR_API_KEY for authentication. You can execute queries and mutations to create, update, and fetch issues, projects, and teams without needing OAuth.

Do I need OAuth to authenticate Linear API requests for issue management?

No, you do not need OAuth to authenticate Linear API requests. This issue management approach uses a personal LINEAR_API_KEY directly in curl headers, bypassing complex OAuth flows for straightforward GraphQL queries and updates.

Can I automate Linear project management tasks from a CI/CD pipeline?

Yes, you can automate Linear project management tasks within a CI/CD pipeline. By scripting curl commands to send GraphQL mutations with your LINEAR_API_KEY, you can automate issue creation, status updates, and data retrieval to feed dashboards or sync external trackers.

What is the best way to sync Linear issues to an external tracker?

Using the Linear GraphQL API with curl is an effective way to sync Linear issues to an external tracker. You can script curl POST requests with your LINEAR_API_KEY to automatically query newly opened issues and push the data to your external system for visibility.

Does Linear GraphQL API support updating team states and projects via curl?

Yes, the Linear GraphQL API supports updating team states and projects via curl. You can construct specific GraphQL mutations and send them as POST requests to https://api.linear.app/graphql with your LINEAR_API_KEY to programmatically update project and team states.