linear

Automate Linear data management via GraphQL API and Python CLI.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/LamseyahElias/jarvis-cloud-v2 --skill linear-lamseyahelias
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/LamseyahElias/jarvis-cloud-v2/tree/main/hermes-agent/skills/productivity/linear
Command: npx skills add https://github.com/LamseyahElias/jarvis-cloud-v2 --skill linear-lamseyahelias

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

GraphQL-based automation of Linear task management removes manual tracking of issues, projects, and teams by exposing a programmable API for common workflows.

Core Features & Use Cases

  • GraphQL API access to query teams, projects, issues, states, and documents for integrated automation and reporting.
  • CLI script (scripts/linear_api.py) to perform common tasks like whoami, list-issues, create-issue, update-status, and fetch documents without building your own client.
  • End-to-end workflow support for listing, filtering, creating, updating, and commenting on issues, plus a document fetch workflow.

Quick Start

Export LINEAR_API_KEY and run the CLI command whoami to verify authentication.

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 via GraphQL API?

Automate Linear issue management by sending GraphQL POST requests to api.linear.app. This approach allows you to programmatically query teams, list projects, update issue statuses, and fetch documents without manual tracking.

What do I need to authenticate Linear API requests?

Authenticating Linear API requests requires a valid LINEAR_API_KEY. You must export this key in your environment before running the Python CLI commands to verify access and interact with your Linear workspace data.

How to list and create Linear issues using a CLI?

List and create Linear issues using a Python CLI script. Running commands like list-issues or create-issue executes GraphQL queries against the Linear API, returning fetched issue data or confirming the newly created issue.

Can I fetch Linear documents across different teams?

You can fetch Linear documents across different teams using the GraphQL API. The workflow supports querying states and documents, enabling integrated reporting and automated data extraction from your entire Linear workspace.

What are the limitations of using GraphQL for Linear automation?

Limitations include depending entirely on the Linear GraphQL API's schema and rate limits. Automating Linear tasks via GraphQL requires a valid LINEAR_API_KEY and Python CLI execution, restricting use to environments supporting these prerequisites.