linear

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables programmatic control of Linear workflows by using the GraphQL API to manage issues, projects, and teams via simple API key authentication, eliminating manual UI tasks.

Core Features & Use Cases

  • API-driven issue and project management: create, update, search, and organize Linear items using curl.
  • Team and workflow control: list teams, retrieve workflow states, and perform bulk updates across multiple issues.
  • OAuth-free integration: authenticates with a LINEAR_API_KEY and requires no OAuth flow for typical tasks.
  • Use Case: automatically triage incoming work and apply initial states across a set of issues in a single automation run.

Quick Start

Set LINEAR_API_KEY in your environment and run a curl command to query your viewer.

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?▼

You can manage Linear issues using the GraphQL API by authenticating with a LINEAR_API_KEY and executing curl commands to query, create, and update items programmatically without manual UI interaction.

Can I automate Linear project workflows without OAuth?▼

Yes, you can automate Linear project workflows without OAuth by setting the LINEAR_API_KEY environment variable to authenticate GraphQL API requests directly via curl for issue and team management.

How do I list Linear teams and workflow states via curl?▼

To list Linear teams and workflow states via curl, send an authenticated GraphQL query to the Linear API endpoint using your LINEAR_API_KEY, retrieving team configurations and available workflow states.

Do I need a Linear API key to update issue states in bulk?▼

Yes, you need a Linear API key stored in the LINEAR_API_KEY environment variable to perform bulk updates on issue states through authenticated GraphQL API requests using curl.

What are the limitations of managing Linear projects with curl?▼

Managing Linear projects with curl requires manual construction of GraphQL queries and relies strictly on the LINEAR_API_KEY for authentication, lacking built-in error handling or automated OAuth refresh flows.