Linear CLI
Command-line interface for Linear issue management.
Search Issues
bash
# 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
bash
# By short ID streamlinear-cli get ABC-123 # By URL streamlinear-cli get "https://linear.app/team/issue/ABC-123"
Update Issue
bash
# 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
bash
streamlinear-cli comment ABC-123 "Fixed in commit abc123" streamlinear-cli comment ABC-123 "Blocked on dependency update"
Create Issue
bash
# 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
bash
streamlinear-cli teams
Raw GraphQL
bash
streamlinear-cli graphql "query { viewer { name email } }"
streamlinear-cli graphql "query { projects { nodes { id name } } }"
Priority Reference
| Value | Label |
|---|---|
| 0 | No priority |
| 1 | Urgent |
| 2 | High |
| 3 | Medium |
| 4 | Low |
Authentication
Token can be provided in order of precedence:
bash
# 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