linear

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Linear workflow management is streamlined by programmatic GraphQL API access to manage issues, projects, and teams, replacing slower UI-only processes.

Core Features & Use Cases

  • API-driven workflow management: list, create, update, and comment on issues, projects, and teams.
  • Scripted automation: use the included Python CLI (scripts/linear_api.py) for ergonomic GraphQL queries.
  • Document access: fetch and inspect related documents and workspace data via GraphQL endpoints.

Quick Start

Set LINEAR_API_KEY in your environment and run the Linear CLI to query teams, issues, or create/update items.

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

You can automate Linear issue management by using a Python CLI script to send GraphQL queries, which lists, creates, and updates issues programmatically. This requires setting your LINEAR_API_KEY environment variable to authenticate requests.

Can I filter Linear issues by team, status, or assignee from the command line?

Yes, you can filter Linear issues by team, status, assignee, and labels directly from the command line. The Python CLI script passes these parameters to GraphQL queries to return targeted issue lists.

Do I need a LINEAR_API_KEY to use the Linear CLI for workflow automation?

Yes, a LINEAR_API_KEY environment variable is required to authenticate GraphQL API requests. The CLI script uses curl to interact with Linear endpoints, making this API key mandatory for listing or updating projects.

What's the best way to create and update Linear projects without the UI?

The best way to create and update Linear projects without the UI is using the included Python CLI script. It provides ergonomic GraphQL access to manage teams, issues, and documents through command-line automation.

Can I fetch Linear workspace documents and team states via GraphQL?

Yes, you can fetch and inspect Linear workspace documents and team states via GraphQL endpoints. The CLI script supports listing states, documents, and projects alongside standard issue management operations.