Linear CLI

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

Installation

``bash


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):

`bash
lc init


Enter your API key when prompted


`

$3

Linear CLI supports multiple profiles for managing different Linear workspaces:

`bash


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

$3

`bash


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"
`

$3

`bash


List projects

lc project list --team ENG

Create project

lc project create --name "Q1 Goals" --team ENG
`

$3

`bash


List teams

lc team list

List users

lc user list --query "john"
`

$3

`bash


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:

`bash


Human-readable table format (default)

lc issue list --team ENG

JSON format for scripting

lc issue list --team ENG --json | jq '.[].title'
`

Development

`bash


Install dependencies

npm install

Build

npm run build

Run tests

npm test

Release new version

mise release [major|minor|patch]
``

License

MIT