johnlindquist/claude/linear

bun add -g linearis

export LINEAR_API_KEY=lin_api_xxxxx

# List issues (default: 25)
linearis issues list
 
# Limit results
linearis issues list --limit 10

# Search by query
linearis issues search "bug"
 
# Filter by team
linearis issues search "authentication" --team ENG
 
# Filter by assignee
linearis issues search "feature" --assignee user-id
 
# Filter by project
linearis issues search "api" --project "Backend"
 
# Filter by status
linearis issues search "bug" --status "In Progress,Todo"
 
# Combined filters with limit
linearis issues search "urgent" --team ENG --limit 5

# Read issue by ID or identifier
linearis issues read ENG-123
linearis issues read abc123-uuid

# Basic issue (requires team)
linearis issues create "Fix login bug" --team ENG
 
# With description
linearis issues create "Add OAuth support" --team ENG -d "Implement Google OAuth"
 
# With priority (1=Urgent, 2=High, 3=Medium, 4=Low)
linearis issues create "Critical fix" --team ENG -p 1
 
# With assignee
linearis issues create "Review code" --team ENG --assignee user-id
 
# With labels
linearis issues create "Security issue" --team ENG --labels "bug,security"
 
# With project
linearis issues create "New feature" --team ENG --project "Q1 Roadmap"
 
# With status
linearis issues create "Started task" --team ENG --status "In Progress"
 
# Full example
linearis issues create "Implement caching" \
  --team ENG \
  -d "Add Redis caching for API responses" \
  -p 2 \
  --labels "feature,performance" \
  --project "Backend" \
  --status "Todo"

# Update title
linearis issues update ENG-123 -t "New title"
 
# Update description
linearis issues update ENG-123 -d "Updated description"
 
# Change status
linearis issues update ENG-123 -s "In Progress"
linearis issues update ENG-123 -s "Done"
 
# Change priority
linearis issues update ENG-123 -p 1
 
# Change assignee
linearis issues update ENG-123 --assignee user-id
 
# Add labels (default mode: adding)
linearis issues update ENG-123 --labels "urgent,blocked"
 
# Replace all labels
linearis issues update ENG-123 --labels "new-label" --label-by overwriting
 
# Clear all labels
linearis issues update ENG-123 --clear-labels
 
# Set parent issue
linearis issues update ENG-123 --parent-ticket ENG-100
 
# Clear parent
linearis issues update ENG-123 --clear-parent-ticket
 
# Set cycle
linearis issues update ENG-123 --cycle "Sprint 5"
 
# Clear cycle
linearis issues update ENG-123 --clear-cycle

# Add comment to issue
linearis comments create ENG-123 --body "Working on this now"

# List all teams
linearis teams list

# List all labels
linearis labels list

# List projects
linearis projects list

# List cycles
linearis cycles list

# List users
linearis users list

# 1. Find the issue
linearis issues search "feature name" --team ENG
 
# 2. Get details
linearis issues read ENG-123
 
# 3. Update status to In Progress
linearis issues update ENG-123 -s "In Progress"
 
# 4. Create branch (from issue identifier)
git checkout -b eng-123-feature-name

# 1. Update status
linearis issues update ENG-123 -s "Done"
 
# 2. Add completion comment
linearis comments create ENG-123 --body "Completed in PR #456"

# My in-progress issues
linearis issues search "assignee:me" --status "In Progress"
 
# Team's blocked issues
linearis issues search "" --team ENG --status "Blocked"

# Find unassigned bugs
linearis issues search "label:bug" --team ENG
 
# Assign and prioritize
linearis issues update ENG-456 --assignee user-id -p 1

git commit -m "feat: implement caching
 
Fixes ENG-123"

ISSUE_ID="ENG-123"
gh pr create --title "feat: implement caching" --body "Closes $ISSUE_ID"