| name | linear |
| description | Use when working with Linear issues/projects: create, update, query, comment, attach files, or inspect Linear URLs/tickets. |
Using Linear
Manage Linear issues, projects, cycles, teams, labels, and documents using the linear CLI.
Authentication
The CLI uses credentials managed via linear auth. If auth fails, ask the user to run linear auth.
Quick Reference
Issues
linear issue list
linear issue view ENG-123
linear issue create
linear issue update ENG-123
linear issue start ENG-123
linear issue url ENG-123
linear issue title ENG-123
linear issue describe ENG-123
linear issue comment
linear issue attach ENG-123 ./file.png
linear issue pr ENG-123
linear issue delete ENG-123
linear issue relation
linear issue id
Projects
linear project list
linear project view <projectId>
linear project create
linear project update <projectId>
linear project delete <projectId>
Project Updates
linear project-update
Cycles
linear cycle list
linear cycle view <cycleRef>
Teams
linear team list
linear team members [teamKey]
linear team id
linear team create
linear team delete <teamKey>
linear team autolinks
Labels
linear label list
linear label create
linear label delete <nameOrId>
Documents
linear document list
linear document view <id>
linear document create
linear document update <documentId>
linear document delete [documentId]
Other
linear api [query]
linear config
linear schema
Workspace Targeting
Use -w <slug> on any command to target a specific workspace:
linear -w mycompany issue list
Common Patterns
Get issue from current branch
linear issue id
linear issue view $(linear issue id)
Create issue with all fields
linear issue create --title "Bug: login fails" --team ENG --priority urgent --label bug
Update issue status
linear issue update ENG-123 --state "In Progress"
Error Handling
| Error | Solution |
|---|
| "Not authenticated" | Run linear auth |
| "Issue not found" | Check issue ID format (e.g., ENG-123) |
| "Team not found" | Run linear team list to see available teams |