Linear CLI Agent Skill

Use this skill when the user wants to interact with Linear - a project management tool for software teams. The linear CLI provides full access to Linear's API for managing issues, projects, teams, cycles, labels, and users.

When to Use This Skill

Activate this skill when the user:

• Mentions Linear, Linear issues, or Linear tickets

• Wants to create, update, or view issues/tickets

• Asks about project status or progress

• Needs to manage sprints/cycles

• Wants to check their assigned tasks

• Mentions issue identifiers like TECH-123 , ENG-456 , etc.

Prerequisites

The CLI must be authenticated. Check with:

linear auth status

If not authenticated, guide the user to run:

linear auth login

Command Reference

Issues (Most Common)

List issues with filters

linear issues list --team <TEAM> linear issues list --team <TEAM> --state "In Progress" linear issues list --assignee me linear issues list --project "Project Name"

View issue details (supports both formats)

linear issues view TECH-123 linear issues view <uuid>

Create new issue

linear issues create --title "Title" --team TECH linear issues create --title "Title" --team TECH --description "Details" --priority 2 --assignee me

Update issue

linear issues update TECH-123 --state "In Progress" linear issues update TECH-123 --assignee "John Doe" linear issues update TECH-123 --priority 1

Add comment

linear issues comment TECH-123 --body "Comment text"

View comments

linear issues comments TECH-123

Archive/delete issue

linear issues delete TECH-123

Projects

linear projects list linear projects view "Project Name" linear projects create --name "New Project" --teams TECH,DESIGN linear projects update "Project Name" --state completed

Teams

linear teams list linear teams view TECH

Cycles (Sprints)

linear cycles list --team TECH linear cycles current --team TECH linear cycles view <cycle-id> linear cycles create --team TECH --starts-at 2024-01-01 --ends-at 2024-01-14

Labels

linear labels list linear labels list --team TECH linear labels create --name "bug" --color "#ff0000"

Users

linear users list linear users me linear users view "User Name"

Workflow States

linear states list --team TECH

Output Formats

All commands support --json for machine-readable output:

linear issues list --team TECH --json

Use --no-color to disable colored output.

Common Patterns

Find my open issues

linear issues list --assignee me --state "In Progress"

Create a bug report

linear issues create --title "Bug: description" --team TECH --priority 2 --labels "bug"

Move issue to done

linear issues update TECH-123 --state "Done"

Get issue details as JSON for processing

linear issues view TECH-123 --json

Check current sprint progress

linear cycles current --team TECH

Priority Levels

• 0

• No priority

• 1

• Urgent

• 2

• High

• 3

• Medium

• 4

• Low

Tips for Agents

• Always check authentication first before running commands

• Use --json flag when you need to parse output programmatically

• Team is often required - ask the user or use linear teams list to find available teams

• Issue identifiers (like TECH-123) are preferred over UUIDs for readability

• Use me as assignee to refer to the authenticated user

• Workflow states vary by team - use linear states list --team <TEAM> to see valid states