---

name: linear-issues description: Manage Linear issues - list, create, update, start/stop work. Use when working with Linear issues, viewing tasks, creating bugs, or updating issue status. allowed-tools: Bash(linear-cli:*)

Linear Issues

Manage Linear.app issues using the linear-cli command-line tool.

List Issues

Copy# List all issues
linear-cli i list

# Filter by team
linear-cli i list -t Engineering

# Filter by status
linear-cli i list -s "In Progress"

# Get JSON output (for parsing)
linear-cli i list --output json

View Issue Details

Copy# View issue details
linear-cli i get LIN-123

# Get as JSON
linear-cli i get LIN-123 --output json

Create Issues

Copy# Create issue (priority: 1=urgent, 2=high, 3=medium, 4=low)
linear-cli i create "Bug: Login fails" -t Engineering -p 2

# Create with status
linear-cli i create "Feature request" -t ENG -s "Backlog"

Update Issues

Copy# Update status
linear-cli i update LIN-123 -s Done

# Update priority
linear-cli i update LIN-123 -p 1

Start/Stop Work

Copy# Start working (assigns to you, sets In Progress, creates git branch)
linear-cli i start LIN-123 --checkout

# Stop working (unassigns, resets status)
linear-cli i stop LIN-123

Comments

Copy# List comments
linear-cli cm list LIN-123

# Get comments as JSON
linear-cli cm list LIN-123 --output json

# Add comment
linear-cli cm create LIN-123 -b "Fixed in latest commit"

Tips

• Use --output json for machine-readable output
• Short alias: i for issues, cm for comments
• Run linear-cli i --help for all options