Linear CLI

Overview

The Linear CLI (linear) provides command-line access to Linear issue tracking. Installed via Homebrew at /opt/homebrew/bin/linear.

Required Configuration

Commands require LINEAR_ISSUE_SORT to be set:

export LINEAR_ISSUE_SORT=priority

Without this, most commands will fail.

Team

Use linear team list to discover available teams.

Issue States

State	Description
triage	New issues needing triage
backlog	Prioritized but not started
unstarted	Ready to start (Todo)
started	In Progress
completed	Done
canceled	Canceled/Won't do

Common Commands

List Issues

# Active issues (excludes completed/canceled)
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager

# Filter by state
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s started -s unstarted

# All issues including completed/canceled
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager --all-states

View Issue

LINEAR_ISSUE_SORT=priority linear issue view WDY-123 --no-pager

Update Issue Status

linear issue update WDY-123 --state "Done"
linear issue update WDY-123 --state "In Progress"

Create PR Linked to Issue

linear issue pr WDY-123

List Teams

linear team list

Workflows

Check Issues to Close

# List active issues
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s started -s unstarted -s backlog

# Cross-reference with recent commits
git log --oneline -30 --all

Triage New Issues

# View issues in triage
LINEAR_ISSUE_SORT=priority linear issue list --team WDY --no-pager -s triage