Releases: otaviosoaresp/linear-cli
Releases · otaviosoaresp/linear-cli
v0.2.0
New Features
Issue Management
- Create issues: New
linear issue createcommand to create issues with full support for all fields - Update issues: New
linear issue updatecommand to update existing issues - Sub-issues support: Create sub-issues using the
--parentflag
Team Management
- List teams: New
linear team listcommand 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-cliUsage 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 listLinear CLI with Smart Filters and Color Support
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-statusflags or inline^Statusnotation - 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 linkQuick 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 priorityViewing
# Issue details with colored badges
linear issue view CAR-123
# Comments on an issue
linear issue comment list CAR-123Color 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