linear

Automate GraphQL interactions with Linear to manage issues, projects, and documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Linear teams need a lightweight way to manage issues, projects, and documents via a GraphQL API from CLI or scripts, without complex setup.

Core Features & Use Cases

  • GraphQL-based interactions with Linear: list projects, issues, documents; create/update issues; fetch documents.
  • Zero-dependency Python helper script and curl-based commands; works with environment variable LINEAR_API_KEY.
  • Use case: quickly fetch issues for a sprint, create an issue from a chat, or retrieve a document summary for onboarding.

Quick Start

Set LINEAR_API_KEY in your environment and run the CLI to list teams.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I automate Linear GraphQL tasks via CLI?

You can automate Linear GraphQL tasks via CLI using a zero-dependency Python helper script and curl-based HTTP calls to manage issues, projects, and documents without a GUI. Set the LINEAR_API_KEY environment variable to authenticate requests.

Can I create and update Linear issues using a script?

Yes, you can create and update Linear issues using a script by executing GraphQL mutations through curl commands or the provided Python helper. This allows quick issue creation directly from chat or automated workflows.

Do I need any dependencies to run GraphQL queries against Linear?

No dependencies are required to run GraphQL queries against Linear. The automation relies on standard curl-based HTTP calls and a zero-dependency Python helper script, needing only the LINEAR_API_KEY environment variable for setup.

What's the best way to fetch Linear projects and documents from the CLI?

The best way to fetch Linear projects and documents from the CLI is using the bundled Python script or curl commands to send GraphQL queries. This retrieves document summaries and project lists quickly for onboarding or sprint reviews.

Why use CLI automation instead of the Linear GUI for managing issues?

Use CLI automation instead of the Linear GUI to enable scripted, lightweight access to Linear data for repetitive workflows. It allows teams to quickly fetch sprint issues or create tickets from automated triggers without manual interface interaction.