linear-cli

Manage Linear issues and projects via command line.

1|Updated Feb 19, 2025
One-click install
npx skills add https://github.com/trystan2k/favoritable-old --skill linear-cli-trystan2k
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-cli
Source: https://github.com/trystan2k/favoritable-old/tree/main/.agents/skills/linear-cli
Command: npx skills add https://github.com/trystan2k/favoritable-old --skill linear-cli-trystan2k

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @std/path, linear-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Manually navigating the Linear web UI to manage issues, projects, and team workflows is slow and disruptive for developers who prefer working in the terminal. This Skill removes that friction by letting you control every aspect of your Linear workspace directly from the command line.

Core Features & Use Cases

  • Full Linear Resource Control: Create, update, view, and delete issues, projects, initiatives, labels, cycles, milestones, and documents without leaving your terminal.
  • Development Workflow Integration: Automatically link issues to your current git or jj branch, generate pull requests pre-populated with issue context, and track commits tied to Linear tasks.
  • Bulk Operations & Safe Markdown Handling: Efficiently process multiple issues or labels at once using bulk flags or file/stdin input, and use file-based flags to properly format markdown content in issue descriptions and comments without shell escaping errors. For example, a development team can use this Skill to bulk archive completed sprint issues, create project status updates with rich markdown, and link related issues to high-level initiatives in seconds.

Quick Start

Use the linear-cli skill to create a new Linear issue titled Fix login bug with a description of the bug reproduction steps and assign it to yourself for the current sprint.

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 and projects from the command line?

Managing Linear issues and projects from the command line requires a CLI tool to execute GraphQL API operations, allowing you to create, update, view, and delete resources without navigating the Linear web UI.

Can I bulk update Linear issues and labels using a CLI?

Yes, you can bulk update Linear issues and labels using a CLI by processing multiple items at once with bulk flags or file and standard input, enabling efficient bulk task management for agile development teams.

Do I need the linear CLI installed to automate issue tracking?

Yes, automating issue tracking requires the linear CLI v1.11.1 installed on your PATH with valid Linear workspace authentication credentials to execute GraphQL API operations for all supported resource types.

What is the best way to add markdown to Linear issue descriptions without shell escaping errors?

The best way to add markdown to Linear issue descriptions without shell escaping errors is using file-based flags, which properly format markdown content in issue descriptions and comments during CLI execution.

Does CLI-based project management support sprint planning and cycle tracking in Linear?

Yes, CLI-based project management supports sprint planning and cycle tracking in Linear by allowing you to create, update, and view cycles, milestones, and initiatives directly from terminal commands.

Why does managing Linear tasks through the web UI slow down developer workflows?

Managing Linear tasks through the web UI slows down developer workflows because manually navigating the interface disrupts terminal-focused development, whereas CLI automation eliminates this friction by controlling workspace resources directly.