linr

a fast Linear CLI client

linr is a fast, single-binary command-line client for Linear. Manage issues, projects, and cycles — create, update, search, and triage your Linear workspace straight from the terminal, no browser required.

bash

$ linr auth login --api-key

Entities →

linr list initiatives|teams|projects|issues|members|labels --json
linr create|update|delete <initiative|project|issue> ...
linr move issue <id> --team <t> --project <p>
linr move project <id> --initiative <i>
linr transition issue <id> --state <name>
linr transition project <id> --status <name>
linr transition initiative <id> --status <value>

Getting Started →

First, install linr — the vendor curl | sh installer is the recommended way in, with Homebrew, Cargo, and from-source alternatives on the Install page.

Authenticate

linr auth login --api-key

Check which credential is in effect:

linr auth status …

Install →

linr is a single self-contained Rust binary — no runtime, no dependencies. The vendor curl | sh installer below is the recommended way in; other paths follow.

Vendor install (curl | sh) — recommended

The site hosts install.sh, so the first install is a short bootstrap that drops the binary on your PATH …

Labels, Comments, Attachments →

linr label create|update|delete|retire|restore ...
linr label add|remove <issue-id> <label>
linr comment add <parent-id> <body> --entity issue|project|initiative
linr comment resolve|unresolve <id>
linr attach upload <issue-id> <file>
linr attach download <id> -o <path>

Relationships →

linr relate issue <id> <related-id> --type blocks|duplicate|related|similar
linr relate project <id> <related-id> --anchor start|end|milestone --related-anchor ...
linr relate initiative <id> <related-id>
linr relate <entity> <relation-id> x --delete

Reports →

linr report issues --csv --team <key> --state <name> --label <name> > out.csv

Self-update and Skills →

linr self update --check
linr self update
linr skills list|install|status|upgrade --dest <dir>