managing-linear

name	managing-linear
description	Manages Linear issues via CLI using linearis (czottmann/linearis). Use when the user mentions Linear issue identifiers (e.g., 'ENG-123'), teams, cycles, projects, labels, issue management, or workflow automation. Handles issue CRUD, comments, cycle/project/label/team/user listing, document management, file embeds, search, and GitHub/GitLab PR linking via issue identifiers.
allowed-tools	["Bash"]

Managing Linear

CLI-based Linear operations using linearis (czottmann/linearis).

Quick Start

Verify authentication before any operation:

npx -y linearis teams list

If this fails, inform the user to set up authentication:

1. Get a Personal API key from Linear: Settings > "Security & Access" > "Personal API keys"
2. Save the token to ~/.linear_api_token, or export LINEAR_API_TOKEN=<token>

Workflow Patterns

Start Work on Issue

# Read the issue
npx -y linearis issues read ENG-123

# Update status to In Progress
npx -y linearis issues update ENG-123 --status "In Progress"

Complete Issue

# Move to done and add a comment
npx -y linearis issues update ENG-123 --status "Done"
npx -y linearis comments create ENG-123 --body "Completed in PR #456"

Daily Standup