linear-cli

Manage Linear issues, projects, and teams from the command line.

3|Updated Apr 21, 2024
One-click install
npx skills add https://github.com/gabrielfruet/.dotfiles --skill linear-cli-gabrielfruet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-cli
Source: https://github.com/gabrielfruet/.dotfiles/tree/main/pi/agent/skills/linear-cli
Command: npx skills add https://github.com/gabrielfruet/.dotfiles --skill linear-cli-gabrielfruet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually switching between Linear's web UI and your terminal to manage work items is inefficient and disrupts workflow for developers and product managers.

Core Features & Use Cases

  • Full Linear CLI Coverage: Manage issues, projects, teams, cycles, milestones, initiatives, labels, documents, and status updates via comprehensive command support.
  • Development Workflow Integration: Link commits and branches to Linear issues with native git and jj support, and create pull requests pre-filled with issue context.
  • Use Case: A product manager can quickly update project status and assign issues during team sync, while a developer can create, update, and link issues to code changes without leaving their terminal.

Quick Start

Use the linear-cli skill to create a new Linear issue titled 'Fix mobile navigation bug' with a markdown description of the reproduction steps, assign it to the frontend team, and link it to the Q2 mobile improvement project.

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 instead of the web UI?

You can manage Linear issues from the command line by executing CLI commands to create, update, and track issues, projects, and cycles. This replaces manual web UI interactions and requires the linear CLI tool to be installed and authenticated with your Linear workspace.

Can I link git commits to Linear issues automatically from my terminal?

Yes, you can link git commits to Linear issues directly from your terminal. The skill provides native git and jj integration, allowing you to link branches and commits to specific issues and create pull requests pre-filled with issue context.

What Linear project management features are supported by command line automation?

Command line automation supports end-to-end operations for issues, projects, teams, cycles, milestones, initiatives, labels, and documents. You can also generate status updates to keep project tracking synchronized without leaving your terminal.

Do I need to authenticate the linear CLI tool before managing project workflows?

Yes, you must install and authenticate the linear CLI tool with your Linear workspace before executing any commands. Authentication is required to process API requests and perform automated issue tracking operations successfully.

What is the best way to create a Linear issue with a markdown description via CLI?

The best way to create a Linear issue via CLI is to run a command specifying the title, markdown description, team, and project. This automates issue creation and assignment directly from your terminal during development workflows.