Linear Project Management

Manage Linear projects, issues, and workflows using the official Linear SDK.

Quick Start

All commands use skills/linear/scripts/linear-cli.js:

node skills/linear/scripts/linear-cli.js <command> [args]

Core Commands

Teams & Projects

List teams:

node skills/linear/scripts/linear-cli.js teams

List projects:

node skills/linear/scripts/linear-cli.js projects

Create project:

node skills/linear/scripts/linear-cli.js createProject "Project Name" "Description" "teamId1,teamId2"

Issues

List issues:

node skills/linear/scripts/linear-cli.js issues
# With filter:
node skills/linear/scripts/linear-cli.js issues '{"state":{"name":{"eq":"In Progress"}}}'

Get issue details:

node skills/linear/scripts/linear-cli.js issue ENG-123

Create issue:

node skills/linear/scripts/linear-cli.js createIssue "Title" "Description" "teamId"
# With options (priority, projectId, assigneeId, etc.):
node skills/linear/scripts/linear-cli.js createIssue "Title" "Description" "teamId" '{"priority":2,"projectId":"project-id"}'

Update issue:

node skills/linear/scripts/linear-cli.js updateIssue "issueId" '{"stateId":"state-id","priority":1}'

Comments

Add comment:

node skills/linear/scripts/linear-cli.js createComment "issueId" "Comment text"

States & Labels

Get team states:

node skills/linear/scripts/linear-cli.js states "teamId"

Get team labels:

node skills/linear/scripts/linear-cli.js labels "teamId"

User Info

Get current user:

node skills/linear/scripts/linear-cli.js user

References

• API.md: Priority levels, filter examples, and common workflows
• Read when you need examples of complex filters or workflow patterns

Common Workflows

Create task for a specific project

1. Get your team ID: node skills/linear/scripts/linear-cli.js teams
2. Get your project ID: node skills/linear/scripts/linear-cli.js projects
3. Create issue with the IDs:

node skills/linear/scripts/linear-cli.js createIssue "Implement login" "Add OAuth login flow" "your-team-id" '{"projectId":"your-project-id","priority":2}'

Move issue to different state

1. Get states: node skills/linear/scripts/linear-cli.js states "teamId"
2. Update issue: node skills/linear/scripts/linear-cli.js updateIssue "issueId" '{"stateId":"state-uuid"}'

Assign issue to yourself

1. Get your user ID: node skills/linear/scripts/linear-cli.js user
2. Update issue: node skills/linear/scripts/linear-cli.js updateIssue "issueId" '{"assigneeId":"your-user-id"}'

Output Format

All commands return JSON. Parse output for programmatic use or display to user as needed.