Linear Lite CLI

A lightweight CLI for Linear - create and manage issues from your terminal.

Features

• Create issues with title, description, team, assignee, and labels
• List issues with filtering options
• Start working on issues
• Open issues in browser, app, or view details in terminal
• Get issue URLs for sharing
• Configure default team and preferences
• List available teams

Installation

Option 1: Use without installing (recommended)

npx linear-lite [command]

Option 2: Global installation

npm install -g linear-lite
linear-lite [command]

Option 3: Local installation

npm install linear-lite
# Then use in package.json scripts:
# "scripts": {
#   "create-issue": "linear-lite issue create"
# }

First Time Setup

1. Get your Linear API key from https://linear.app/settings/api
2. Run:

linear-lite config init

Usage

# Create a new issue
linear-lite issue create "Bug: Login not working" --description "Users cannot log in" --team ENG

# List issues
linear-lite issue list

# Start working on an issue
linear-lite issue start ENG-123

# Open an issue in browser
linear-lite issue open ENG-123

# Get issue URL
linear-lite issue url ENG-123

# List teams
linear-lite teams list

Commands

Issue Management

• linear-lite issue create [TITLE] - Create a new issue

  • --description, -d - Issue description (markdown supported)
  • --team, -t - Team identifier (e.g., ENG)
  • --assignee, -a - Assignee email
  • --label, -l - Label name
  • --priority, -p - Priority level (low|medium|high|urgent)

• linear-lite issue list - List issues

  • --team - Filter by team
  • --status - Filter by status
  • --assignee - Filter by assignee
  • --limit - Max issues to show (default: 20)

• linear-lite issue start [IDENTIFIER] - Start working on an issue

  • --team - Team identifier (when using number only)

• linear-lite issue open [IDENTIFIER] - Open issue

  • --app - Open in Linear desktop app (default: false)
  • --browser - Open in web browser (default: true)
  • --team - Team identifier (when using number only)

• linear-lite issue url [IDENTIFIER] - Get issue URL

  • --app - Get app URL instead of web URL
  • --team - Team identifier (when using number only)

Team Management

• linear-lite teams list - List all teams

Configuration

• linear-lite config init - Configure Linear CLI settings

  • --force - Override existing config

• linear-lite help [COMMAND] - Display help for linear-lite commands

Development

# Clone the repository
git clone https://github.com/joedeleeuw/linear-lite.git
cd linear-lite

# Install dependencies
pnpm install

# Build
pnpm build

# Run locally
./bin/dev [command]

License

MIT