linear-cmd

Linear cmd

A GitHub CLI-like tool for Linear - manage issues, accounts, and more from your terminal.

Features

• Multi-account support - Manage multiple Linear accounts with per-command selection
• Complete issue management - Create, list, update, comment, and view detailed issue information
• Smart account discovery - Automatically finds the right account for issue operations
• Advanced filtering - Filter issues by assignee, state, labels, projects, and teams
• Self-updating - Built-in update mechanism that detects your package manager

Motivation

Why build this when we already have Linear MCP?

Because I want to be able to just paste a Linear issue link into my Claude code and have it solve the problem. Currently, the Linear MCP server does not support using multiple Linear accounts (I use one for work and one for my personal projects).

Quick Start

1. Get your Linear API Key from Linear Settings > Security & Access > Personal API keys
2. Add your account: linear account add (Then you need to set a name and paste your API_KEY)
3. View an issue: linear issue show WORK-123

Usage

Installation

npm install linear-cmd -g

General

linear update                              # Update to latest version (auto-detects npm/yarn/pnpm)
linear --help                              # Show available commands
linear <command> --help                    # Show help for specific command

Account Management

linear account add                         # Add account
linear account list                        # List accounts
linear account remove [NAME]               # Remove account 
linear account test                        # Test connection of all your accounts

Issue Management

linear issue show <linear-url>             # Show by URL
linear issue show WORK-123                 # Show by ID
linear issue show WORK-123 --account work  # Show by ID (specifying account)
linear issue list --account work           # List issues (requires account)

Creating Issues

# Interactive mode (prompts for missing fields)
linear issue create --account work

# Direct mode with flags
linear issue create --account work \
  --title "Issue title" \
  --description "Issue description" \
  --priority 2 \
  --label "bug" \
  --team "TEAM" \
  --project "Project Name" \
  --assignee "[e-mail]"

Updating Issues

# Interactive mode (choose what to update)
linear issue update WORK-123

# Direct mode with flags
linear issue update WORK-123 \
  --title "New title" \
  --description "New description" \
  --state "In Progress" \
  --assignee "[e-mail]" \
  --priority 1 \
  --add-label "urgent" \
  --remove-label "low-priority"

Commenting on Issues

# Interactive mode (prompts for comment)
linear issue comment WORK-123

# Direct mode with comment text
linear issue comment WORK-123 "This is my comment"

Shell Completion

Enable autocompletion for commands and subcommands in your shell:

# Install completion for your current shell (auto-detects and gives instructions)
linear completion install

After installation, restart your shell or source your shell config file:

# For zsh
source ~/.zshrc

# For bash  
source ~/.bashrc

Now you can use tab completion:

• linear <TAB> → shows: account, issue, update, completion
• linear account <TAB> → shows: add, list, remove, test
• linear issue <TAB> → shows: show, create, list, update, comment

Development

pnpm run dev                               # Run in development
pnpm run build                             # Build for production
pnpm run test                              # Run tests

License

MIT License - see LICENSE file for details.