Linear CLI

Command-line interface for Linear issue management.

Search Issues

# Your active issues (default)
streamlinear-cli search

# Text search
streamlinear-cli search "auth bug"

# Filter by state
streamlinear-cli search --state "In Progress"

# Filter by assignee
streamlinear-cli search --assignee me
streamlinear-cli search --assignee user@example.com

# Filter by team
streamlinear-cli search --team ENG

# Combine filters
streamlinear-cli search --state "In Progress" --assignee me --team ENG

Get Issue Details

# By short ID
streamlinear-cli get ABC-123

# By URL
streamlinear-cli get "https://linear.app/team/issue/ABC-123"

Update Issue

# Change state
streamlinear-cli update ABC-123 --state Done
streamlinear-cli update ABC-123 --state "In Progress"

# Change priority (1=Urgent, 2=High, 3=Medium, 4=Low)
streamlinear-cli update ABC-123 --priority 1

# Assign to me
streamlinear-cli update ABC-123 --assignee me

# Assign to someone else
streamlinear-cli update ABC-123 --assignee user@example.com

# Unassign
streamlinear-cli update ABC-123 --assignee null

# Multiple updates
streamlinear-cli update ABC-123 --state Done --priority 3

Comment on Issue

streamlinear-cli comment ABC-123 "Fixed in commit abc123"
streamlinear-cli comment ABC-123 "Blocked on dependency update"

Create Issue

# Basic
streamlinear-cli create --team ENG --title "Bug: Login fails"

# With description
streamlinear-cli create --team ENG --title "Bug: Login fails" --body "Users see error on submit"

# With priority
streamlinear-cli create --team ENG --title "Urgent fix" --priority 1

List Teams

streamlinear-cli teams

Raw GraphQL

streamlinear-cli graphql "query { viewer { name email } }"
streamlinear-cli graphql "query { projects { nodes { id name } } }"

Priority Reference

Authentication

Token can be provided in order of precedence:

# Direct token
streamlinear-cli --token lin_api_xxx search

# Token from command (e.g., 1Password, AWS Secrets Manager)
streamlinear-cli --token-cmd "op read 'op://vault/linear/token'" search

# Environment variable fallback
export LINEAR_API_TOKEN=lin_api_xxx
streamlinear-cli search