:star: Features

• Multi-account support - Manage multiple Linear accounts
• Complete issue management - Create, list, update, comment
• Project & document support - Full project and document operations
• Smart account discovery - Automatically finds the right account
• Advanced filtering - Filter by assignee, state, labels, teams
• Self-updating - Built-in update mechanism

:question: Motivation

Why build this when we already have Linear MCP?

Because I want to paste a Linear issue link into Claude Code and have it work with multiple Linear accounts (work + personal).

:rocket: Quick Start

Getting Started:

1. Get your API key from Linear Settings > Account > API
2. Install the CLI:

   npm install linear-cmd -g

3. Add your account:

   linear account add

4. List your issues:

   linear issue list --assignee me

:bulb: Usage

Commands Overview

linear --help                    # Show help
linear update                    # Update to latest version

# Add a new Linear account
linear account add
linear account add --name "work" --api-key "lin_api_..."

# List all configured accounts
linear account list

# Remove a Linear account
linear account remove

# Select the active Linear account
linear account select

# Test account connections
linear account test

# Show issue details
linear issue show ISSUE-123
linear issue show https://linear.app/team/issue/ISSUE-123
linear issue show ISSUE-123 --format json

# Create a new issue
linear issue create --title "Fix bug"
linear issue create --title "New feature" --description "Description" --priority 2
linear issue create --title "Task" --assignee [email protected] --label bug

# List issues
linear issue list
linear issue list --state "In Progress"
linear issue list --assignee [email protected] --limit 20
linear issue list --format json

# Update an issue
linear issue update ISSUE-123 --state Done
linear issue update ISSUE-123 --title "Updated title" --priority 1
linear issue update ISSUE-123 --assignee [email protected]

# Add a comment to an issue
linear issue comment ISSUE-123 --body "Great work!"
linear issue comment ISSUE-123 -b "Need more info"

# List all projects
linear project list
linear project list --format json

# Show project details
linear project show "My Project"
linear project show PROJECT-123 --format json

# List issues in a project
linear project issues "My Project"
linear project issues PROJECT-123 --limit 50

# Create a new project
linear project create --name "New Project"
linear project create --name "Q2 Goals" --description "Goals for Q2 2024"

# Delete a project
linear project delete "Old Project"
linear project delete PROJECT-123

# Show document details
linear document show DOC-123
linear document show https://linear.app/team/doc/DOC-123

# Create a new document
linear document add --title "Meeting Notes"
linear document add --title "RFC" --content "# Proposal\n\nDetails..."

# Delete a document
linear document delete DOC-123

linear completion install

:wrench: Development

pnpm install                     # Install dependencies
pnpm run dev                     # Run in development
pnpm run build                   # Build for production
pnpm run test:e2e                # Run E2E tests

:scroll: License

MIT License - see LICENSE file for details.