Skip to content

Releases: otaviosoaresp/linear-cli

v0.2.0

22 Nov 21:13

Choose a tag to compare

New Features

Issue Management

  • Create issues: New linear issue create command to create issues with full support for all fields
  • Update issues: New linear issue update command to update existing issues
  • Sub-issues support: Create sub-issues using the --parent flag

Team Management

  • List teams: New linear team list command to view all available teams

Supported Fields

Both create and update commands support:

  • Title
  • Description
  • Status (by name)
  • Assignee (by email)
  • Priority (0-4)
  • Labels (by name, multiple)
  • Estimate (story points)

Developer Experience

  • Automatic conversion of names to IDs (teams, statuses, users, labels)
  • Clear error messages
  • Consistent command structure

Installation

npm install -g @scmfury/linear-cli

Usage Examples

# Create a new issue
linear issue create --title "Fix bug" --team "Engineering" --priority 1

# Create a sub-issue
linear issue create --title "Subtask" --team "Engineering" --parent "ENG-123"

# Update an issue
linear issue update ENG-123 --status "In Progress" --assignee "dev@example.com"

# List teams
linear team list

Linear CLI with Smart Filters and Color Support

21 Nov 01:18

Choose a tag to compare

Initial Release

A powerful command-line interface for Linear that brings issue management directly to your terminal with advanced filtering, sorting, and Linear's native color schemes.

Features

Issue Management

  • List issues with customizable table view
  • View issue details with complete metadata
  • Comment management - list and create comments

Advanced Filtering

  • Filter by status, assignee, labels, team, and more
  • Exclusion filters - exclude specific statuses, labels, or assignees
  • Flexible syntax - use --exclude-status flags or inline ^Status notation
  • Multiple values - combine multiple filters for precise results

Smart Sorting

  • Sort by: updated, created, priority, title
  • Ascending or descending order
  • Default: most recently updated first

Visual Excellence

  • Native Linear colors - badges and status use colors directly from your Linear workspace
  • Colored output - status, labels, and priorities displayed with their configured colors
  • Clean table layout - perfectly aligned columns with color support

Installation

npm install
npm run build
npm link

Quick Start

# Authenticate
linear auth login

# List all issues
linear issue list

# Exclude completed issues
linear issue list --exclude-status "Done" "Canceled"

# Filter and sort
linear issue list --status "In Progress" --sort priority

# View issue details
linear issue view LIN-123

# Add a comment
linear issue comment create LIN-123 --body "Great work!"

Tech Stack

  • TypeScript
  • Linear GraphQL SDK
  • Commander.js for CLI
  • Picocolors for terminal colors

Examples

Filtering

# Active issues only
linear issue list --exclude-status "Done"

# Bugs in progress
linear issue list --label "bug" --status "In Progress"

# Unassigned high-priority issues
linear issue list --status "Todo" --sort priority

Viewing

# Issue details with colored badges
linear issue view CAR-123

# Comments on an issue
linear issue comment list CAR-123

Color Support

The CLI uses your Linear workspace's color configuration:

  • Status badges show the exact colors from your workflow states
  • Labels display with their configured colors
  • Priority levels use standard Linear color schemes