Linear Integration
Use linearis CLI for Linear task management. Issue IDs support both UUID and identifiers like ABC-123.
Quick Start
linearis issues list -l 10 # Recent issues
linearis issues read ABC-123 # Issue details
linearis issues search "bug" # Search issues
linearis issues update ABC-123 -s "In Progress" # Update status
Workflow
- Check
linearis issues list before starting work
- Update issue status when you begin (
In Progress)
- Add comments for significant progress
- Link PRs in comments when opening
Issues
List Issues
linearis issues list [options]
| Option |
Description |
-l, --limit <n> |
Limit results (default: 25) |
Read Issue
linearis issues read <issueId>
Create Issue
linearis issues create [options] <title>
| Option |
Description |
-d, --description <desc> |
Issue description |
-a, --assignee <id> |
Assign to user ID |
-p, --priority <1-4> |
Priority level |
--team <team> |
Team key, name, or ID (required if not specified) |
--project <project> |
Add to project (name or ID) |
--labels <labels> |
Labels (comma-separated names or IDs) |
--status <status> |
Status name or ID |
--cycle <cycle> |
Cycle name or ID (requires --team) |
--project-milestone <milestone> |
Project milestone (requires --project) |
--parent-ticket <parentId> |
Parent issue ID or identifier |
Update Issue
linearis issues update [options] <issueId>
| Option |
Description |
-t, --title <title> |
New title |
-d, --description <desc> |
New description |
-s, --state <state> |
New state name or ID |
-p, --priority <1-4> |
New priority |
--assignee <id> |
New assignee ID |
--project <project> |
New project (name or ID) |
Labels:
| Option |
Description |
--labels <labels> |
Labels (comma-separated names or IDs) |
--label-by <mode> |
How to apply: adding (default) or overwriting |
--clear-labels |
Remove all labels |
Relationships:
| Option |
Description |
--parent-ticket <id> |
Set parent issue |
--clear-parent-ticket |
Clear parent |
--project-milestone <milestone> |
Set milestone |
--clear-project-milestone |
Clear milestone |
--cycle <cycle> |
Set cycle |
--clear-cycle |
Clear cycle |
Search Issues
linearis issues search [options] <query>
| Option |
Description |
--team <team> |
Filter by team |
--assignee <id> |
Filter by assignee ID |
--project <project> |
Filter by project |
--states <states> |
Filter by states (comma-separated) |
-l, --limit <n> |
Limit results (default: 10) |
Comments
Create Comment
linearis comments create [options] <issueId>
| Option |
Description |
--body <body> |
Comment body (required) |
Cycles
List Cycles
linearis cycles list [options]
| Option |
Description |
--team <team> |
Team key, name, or ID |
--active |
Only active cycles |
--around-active <n> |
Return active +/- n cycles (requires --team) |
Read Cycle
linearis cycles read [options] <cycleIdOrName>
| Option |
Description |
--team <team> |
Team to scope name lookup |
--issues-first <n> |
Issues to fetch (default: 50) |
Projects
List Projects
linearis projects list [options]
| Option |
Description |
-l, --limit <n> |
Limit results (default: 100) |
Project Milestones
List Milestones
linearis project-milestones list [options]
| Option |
Description |
--project <project> |
Project name or ID |
-l, --limit <n> |
Limit results (default: 50) |
Read Milestone
linearis project-milestones read [options] <milestoneIdOrName>
| Option |
Description |
--project <project> |
Project to scope name lookup |
--issues-first <n> |
Issues to fetch (default: 50) |
Create Milestone
linearis project-milestones create [options] <name>
| Option |
Description |
--project <project> |
Project name or ID |
-d, --description <desc> |
Milestone description |
--target-date <date> |
Target date (YYYY-MM-DD) |
Update Milestone
linearis project-milestones update [options] <milestoneIdOrName>
| Option |
Description |
--project <project> |
Project to scope name lookup |
-n, --name <name> |
New name |
-d, --description <desc> |
New description |
--target-date <date> |
New target date (YYYY-MM-DD) |
--sort-order <n> |
New sort order |
Labels
List Labels
linearis labels list [options]
| Option |
Description |
--team <team> |
Filter by team |
Teams
List Teams
linearis teams list
Users
List Users
linearis users list [options]
| Option |
Description |
--active |
Only show active users |
Embeds
Download File
linearis embeds download [options] <url>
| Option |
Description |
--output <path> |
Output file path |
--overwrite |
Overwrite existing file |