Linear CLI

A powerful command-line interface for Linear, designed for developers who prefer working in the terminal.

Installation

# Quick run with npx
npx linearctl --help

# Or install globally
npm install -g linearctl

Setup

Initialize with your Linear API key (get one from Linear Settings):

lc init
# Enter your API key when prompted

Multi-Profile Support

Linear CLI supports multiple profiles for managing different Linear workspaces:

# Initialize a profile
lc init --profile work
lc init --profile personal

# List all profiles
lc profile list

# Set default profile
lc profile set-default work

# Delete a profile
lc profile delete personal

# Use specific profile with any command
lc issue list --profile work
lc issue create --title "Task" --profile personal

# Or use environment variable
export LINEAR_PROFILE=work
lc issue list  # Uses work profile

Priority Order:

1. --profile flag (highest priority)
2. LINEAR_API_KEY environment variable
3. LINEAR_PROFILE environment variable
4. Default profile (lowest priority)

Usage

Issues

# List issues
lc issue list --team ENG --limit 10

# Get issue details
lc issue get ENG-123

# Create issue
lc issue create --title "Fix bug" --team ENG --assignee "John Doe"

# Update issue
lc issue update ENG-123 --state "In Progress" --priority 2

# List my issues
lc issue mine --state "In Progress"

Projects

# List projects
lc project list --team ENG

# Create project
lc project create --name "Q1 Goals" --team ENG

Teams & Users

# List teams
lc team list

# List users
lc user list --query "john"

Comments

# Add comment
lc comment add ENG-123 --body "Fixed in PR #456"

# List comments
lc comment list ENG-123

Output Formats

All commands support both human-readable (default) and JSON output:

# Human-readable table format (default)
lc issue list --team ENG

# JSON format for scripting
lc issue list --team ENG --json | jq '.[].title'

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Release new version
mise release [major|minor|patch]

License

MIT