linear-integration

Create and manage Linear issues via Bash scripts with curl and jq.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dbmcco/claude-agent-toolkit --skill linear-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-integration
Source: https://github.com/dbmcco/claude-agent-toolkit/tree/main/skills/linear
Command: npx skills add https://github.com/dbmcco/claude-agent-toolkit --skill linear-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the creation, tracking, and management of Linear issues, eliminating manual data entry and ensuring seamless integration with AI-driven project workflows.

Core Features & Use Cases

  • Issue Creation: Quickly create new Linear issues with titles, descriptions, priorities, and project assignments.
  • Issue Management: List, update, and search existing issues by state, assignee, or project.
  • Project Status: Query project details and statuses to keep track of ongoing work.
  • Use Case: Automatically create new Linear issues from user conversations or bug reports, assign them to the correct project and team, and update their status as development tasks progress.

Quick Start

Create a new Linear issue

scripts/linear-create-issue.sh
--title "Fix authentication bug"
--description "Users cannot log in after password reset"

Frequently Asked Questions about linear-integration

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

FAQPage Schema
How do I automate Linear issue creation from external events?

Automate Linear issue creation by using Bash scripts with curl to send REST API requests authenticated with your Linear API key. The Skill provides scripts that parse arguments, construct JSON payloads, and handle API responses, letting you create issues with title, description, priority, and project assignment from workflows or bug reports.

Can I list and update Linear issues programmatically via CLI?

Yes. The Skill includes CLI scripts using curl and jq to list issues filtered by state, assignee, or project, and update issue status as development progresses. Scripts handle environment-based authentication and JSON parsing to extract and modify issue data.

What dependencies do I need to manage Linear issues with Bash scripts?

You need curl for making HTTP requests to Linear's REST API and jq for parsing and formatting JSON responses. Both are lightweight command-line tools that enable argument parsing, payload construction, and structured output handling in Bash scripts.

How do I integrate Linear issue tracking into AI-driven project workflows?

Use the Skill's scripts to automatically create and update Linear issues from conversational triggers or system events. Environment-based authentication and JSON output enable seamless integration with downstream automation, allowing issue status to sync with development task progress.

Can I search and query Linear project details from the command line?

Yes. The Skill provides Bash scripts that query project details and statuses using curl to call Linear's REST API and jq to extract relevant fields, letting you retrieve ongoing work information and filter issues programmatically.

What authentication method does the Linear CLI automation use?

The scripts use environment-based authentication with your Linear API key, eliminating the need to hardcode credentials. This approach supports secure token management and integrates cleanly with CI/CD pipelines and local development workflows.