linear-cli

name	linear-cli
description	Use when interacting with Linear.app from the command line. Triggers on any request involving Linear issues, projects, cycles, sprints, teams, roadmaps, milestones, documents, triage, notifications, comments, bulk operations, or any Linear workflow. Also triggers when the user references a Linear issue identifier (e.g. ENG-123, LIN-456), wants to list/create/update/close/assign issues, check sprint status, run burndown charts, import/export Linear data, manage webhooks, or automate Linear tasks from the terminal. Use proactively whenever the user mentions "Linear", "linear issue", "linear sprint", "linear project", "linear ticket", or any Linear-related workflow — even if they don't explicitly ask for the CLI.
metadata	{"author":"Peter Benjamin","version":"0.2.0"}

Linear CLI Skill

linear is a CLI for Linear.app — v2.0.0.

The binary is linear. Always run linear <command> --help to discover flags for any subcommand before guessing.

Environment Variables

Variable	Purpose
LINEAR_DEBUG=1	Show full error details including stack traces

Multi-Workspace

Pass --workspace <slug> to any command to target a specific workspace:

linear --workspace myorg issue mine

Aliases

Full command	Aliases
issue	i
issue mine	i mine, i list, i l
issue query	i query, i q
issue view	i view, i v
issue pull-request	i pr
issue delete	i d
team	t
project	p
project-update	pu
cycle	cy
milestone	m
initiative	init
initiative-update	iu
label	l
document	docs, doc

Reference

Detailed command reference is in references/:

• auth — authentication and workspace credentials
• issue — create, view, update, start, PR, delete, comments, links, relations
• team — list, create, delete, members, autolinks
• project — list, view, create, update, delete; project-update
• cycle — list, view
• milestone — list, view, create, update, delete
• initiative — full CRUD + project linking; initiative-update
• label — list, create, delete
• document — list, view, create, update, delete
• api — raw GraphQL requests; schema dump
• config — interactive .linear.toml generation
• completions — shell completion setup
• workflows — common multi-step patterns