linear-cli

Manage Linear issues, projects, and milestones via the command line.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/tezra-io/agentic-coding-workflow-skills --skill linear-cli-tezra-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-cli
Source: https://github.com/tezra-io/agentic-coding-workflow-skills/tree/main/skills/linear-cli
Command: npx skills add https://github.com/tezra-io/agentic-coding-workflow-skills --skill linear-cli-tezra-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually managing Linear issues, projects, and milestones through the web UI is slow and disruptive for users who work primarily in the terminal, especially when integrating task tracking with git or jj version control workflows.

Core Features & Use Cases

  • Full Linear CLI Control: Manage all Linear entities including issues, teams, projects, milestones, initiatives, labels, and documents directly from the command line.
  • Git/JJ Integration: Link Linear issues to git or jj branches and commits to automatically track work associated with code changes.
  • Safe Markdown Handling: Built-in guidance for using file-based flags to avoid shell escaping issues when adding multi-line markdown descriptions or comments to issues.
  • Use Case: Engineering teams using Linear for project tracking can create, update, and query issues without switching away from their terminal, and tie task work directly to code commits for full traceability.

Quick Start

Use the linear-cli skill to create a new Linear issue for your current git branch, assign it to the correct project, and populate its description with the contents of your local task notes file.

Frequently Asked Questions about linear-cli

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

FAQPage Schema
How do I manage Linear issues from the command line?

You can manage Linear issues from the command line by using a CLI to create, update, and query all Linear entities including projects, milestones, and labels directly within your terminal environment.

Can I link Linear issues to git branches and commits?

Yes, you can link Linear issues to git or jj branches and commits. This integration automatically tracks task work associated with code changes to maintain full traceability across your version control workflow.

Do I need the linear CLI installed to manage Linear tasks in the terminal?

Yes, managing Linear tasks in the terminal requires the linear CLI version 1.9.1 or higher installed on your system PATH to execute commands and interact with the Linear API.

How do I add multi-line markdown descriptions to Linear issues via CLI?

To add multi-line markdown descriptions to Linear issues via CLI, use file-based flags to pass the content, which avoids shell escaping issues when formatting complex issue details or comments.

What Linear entities can I update without using the web UI?

Without using the web UI, you can update all Linear entities including issues, teams, projects, milestones, initiatives, labels, and documents directly through terminal commands.

Can I run custom GraphQL queries against Linear from the terminal?

Yes, you can run custom GraphQL queries against Linear from the terminal. The CLI provides reference documentation for supported Linear operations, including direct GraphQL API access for custom data retrieval.