Linear Issue Management

Use this skill whenever the user mentions Linear or asks to work with issues.

Lightweight CLI to interact with Linear's issue tracking system. All commands run from the skill directory using ./linear.

Setup

Dependencies install automatically on first run. API key errors are self-explanatory.

Command Pattern

./linear <resource> <action> [arguments] [options]

Resources: issue, user, team, project

Commands

List Users

./linear user list

Returns: #<user-id> <name> <email>

List Teams

./linear team list

Returns: #<team-id> <name> <key>

List Projects

./linear project list

Returns: #<project-id> <name> <state>

List Issues

./linear issue list [options]

Options:

• --team <id> - Filter by team ID
• --assignee <id> - Filter by user ID
• --status <name> - Filter by status name (case-sensitive)
• --limit <n> - Limit results (default: 50)

Returns: #<identifier> <title> <status> <assignee>

Examples:

./linear issue list --team abc123 --limit 10
./linear issue list --assignee def456 --status "In Progress"

View Issue

./linear issue view <id-or-key>

Arguments:

• <id-or-key> - Issue identifier (e.g., ENG-123) or UUID

Returns full issue details including title, status, assignee, team, priority, labels, dates, description, and comments.

Create Issue

./linear issue create <title> [options]

Arguments:

• <title> - Issue title (multi-word titles auto-combined)

Options:

• --team <id> - Team ID (required)
• --description <text> - Issue description
• --assignee <id> - User ID
• --priority <n> - Priority (0=None, 1=Urgent, 2=High, 3=Medium, 4=Low)
• --status <name> - Initial status

Example:

./linear issue create "Fix login bug" --team abc123 --priority 2

Add Comment

./linear issue comment <id-or-key> <text>

Multi-word text auto-combined. No quotes needed.

Update Issue

./linear issue update <id-or-key> [options]

Options:

• --status <name> - Update status
• --assignee <id> - Update assignee
• --priority <n> - Update priority
• --title <text> - Update title
• --description <text> - Update description

Can update multiple fields in one command.

Example:

./linear issue update ENG-123 --status "In Progress" --assignee abc123

Delete Issue

./linear issue delete <id-or-key>

Soft delete (moves to trash, recoverable).

Important Notes

• Issue identifiers are case-insensitive (ENG-123 = eng-123)
• Status names are case-sensitive ("In Progress" ≠ "in progress")
• User/team IDs are UUIDs (get from list commands)
• Issue keys format: <TEAM_KEY>-<NUMBER> (e.g., ENG-123)
• All commands support --json flag for machine-readable output
• Use --help on any command for details